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DOS/VS Serviceability Aids and Debugging Procedures 

THIS MANUAL... PREFACE 

... is intended to guide System/370 operators and programmers using DOS/VS in 
determining and isolating the cause of a system malfunction. 

METHOD OF PRESENTATION 

Serviceability aids and how to use them are described in this manual through 
extensive use of diagrams and examples. This enables fast retrieval of information 
and largely avoids the need to use other publications in order to analyze the dumps 
and printouts discussed. 

Contents and addresses shown in the illustrations are subject to change and are 
shown only as an aid to offline debugging of DOS/VS release 29.. IBM will not be 
responsible for any system malfunction resulting from a change made by the 
user of any contents or addresses of the tables and blocks described. 

SUBJECTS COVERED 
There are four major sections; 

SECTION 1: Introduction, introduces the serviceability aids detailed in Section 2, 
and the debugging procedures described in Sections 3 and 4. 

SECTION 2: Serviceability Aids, describes in detail the serviceability aids, 
showing in flowchart form how to use them, and recommending when to use them. 
Examples show how to analyze dumps and printouts in conjunction with the 
debugging procedures of Section 3 and 4. 

SECTION 3: Debugging for Operators, consists of flowcharts that help the 
operator to isolate the cause of a system malfunction. The operator is instructed 
when to use the procedures of Section 2 to ensure that information is gathered 
from the system. 

SECTION 4: Debugging for programmers, this section is divided into two parts: 

Part 1 consists of checklists in flowchart form that recommend the method of 
analysis and choice of serviceability aids best suited to isolate the cause of a given 
type of system malfunction. An indication is made on the flowcharts when it is 
considered necessary to inform your IBM customer engineer when it is not 
possible to isolate the cause of an error. System information to be saved for the 
IBM CE is also listed at these points in the flowcharts. 

Part 2 is a general description of the DOS/VS supervisor/problem program interface 
tables, information blocks and save areas. It shows how to locate these areas in a 
dump, and how to analyze the data during offline program debugging. Debugging 
aids for high level languages are described in publications dealing with the specific 
language . 

PREREQUISITE KNOWLEDGE 

Operators using this manual must be familiar with the following IBM publications: 

DOS/ VS Operating Procedures GC33 - 53 78 

DOS/VS Messages GC33 - 5379 

Programmers using Section 4 must be familiar with the following IBM publications: 

IBM System I '3 70 Principles of Operation GA 22 - 7000 

DOS/ VS System Management Guide GC33 - 5371 

Other IBM publications referenced in this manual are listed in the bibliography at 
the back. 
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Hands-on debugging 



Detect and 
categorize 
the error. 



+ 



Gather information 
using serviceability aids. 




Offline debugging 



Analyze the 
information. 



> 



Use special "tools' 
if further error 
isolation required. 



1 .2 Introduction 



Serviceability Aids 



Serviceability aids are "tools" offered by IBM and are designed to gather system 
information whenever a malfunction occurs on a System/370. 

A malfunction can be caused by a programming error or by a hardware failure. 

Some of the serviceability aids that gather system information when 
programming errors occur are: 



• 



DUMPS of specified real and virtual address areas 



• DUMPS or DISPLAYS of general registers, 

control registers, 

floating point registers, and 

program status words 

• FORMATTED PRINTOUT of the DOS/VS supervisor tables and 
information blocks 

• The ability to ALTER any register or any area of virtual storage 

• Problem determination aids, PDAIDS (event tracing routines) 

• System debugging aids, SDAIDS (program event recording and 
tracing routines) 

• Disk and tape LABEL INFORMATION display programs 

• LISTIO and MAP commands (aids that list devices used per partition, 

and that map virtual storage organization during system operation) , 

• Commands that allow information contained on disk files using VSAM 
(Virtual Storage Access Method) to be printed, listed, or verified 

• Programs that display libraries and allow them to be edited and 
maintained 

• Error messages issued by the system that inform the operator about 
the nature of an error. 

The serviceability aids that detect hardware failures and produce formatted output 
concerning this failure are: 

• RMS — Recovery Management Support 

• EREP - Environmental Recording, Editing, and Printing 

• OLTEP - Online Test Executive Program 

• SEREP - Stand-alone EREP 

• Micro-program diagnostic aids, (Models 1 15, 125, and 158) 

In addition to the above aids, the Models 115 and 125 are provided with a micro- 
program recording facility that records certain types of hardware errors on 
DISKETTE. The errors recorded on DISKETTE can be displayed and analyzed 
by the IBM CE using the Maintenance Program Selection and Log Analysis displays. 

A similar facility is provided on the Model 158 in the form of displays obtained 
by the use of the Service function. 

A reference chart at the front of Section 2 lists the IBM serviceability aids, which 
are described in detail in that section. 

Serviceability aids offered by IBM that are designed to gather system information 

specifically for use with high-level languages (RPG II, PL/I, American National 

Standard COBOL, and FORTRAN) are not described in this manual. Details about Introduction. ,; 1.3 

these aids are found in the corresponding manuals for the processor being used. 



What is Debugging? 



Debugging is a procedure that is followed to isolate an error (sometimes referred 
to as a bug) that prevents programs from being correctly executed by a computer 
system. 

Debugging requires the coordinated efforts of operators and programmers, and is 
divided into two distinct actions: 

• Hands-on debugging 

• Offline debugging. 

Hands-on debugging entails the examination of available symptoms and 
indications and the saving of information by the operator when a system 
malfunction occurs. 

Offline debugging requires the analysis and the isolation of an error by the 
programmer, using data gathered during hands-on debugging. 

IBM has provided special programs, commands, and procedures called service- 
ability aids, or tools, to help in gathering information about a system malfunction. 
These aids can be initialized by the operator and are of special interest when an 
error is obscure. 

The two debugging actions (hands-on and offline) can be divided into the 
following four phases as shown in figure 1.1: 

1. Determine the type of malfunction. 

2. Gather information. 

3. Analyze the information. 

4. Use aids for further error isolation if required. 
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What is Debugging? 



OPERATORS 



Phase 1 



Recognize the error type: 

Unintended loop 
Wait state 
Incorrect output 
Program checks 
I/O device errors 




I 



Phase 2 

Gather information: 

Messages from SYSLOG 

Line printer output 

Dumps 

A MAP of virtual storage 

A LISTIO of I/O device 

assignments 

Low address storage 
System activity 
Indicator lamps 
EREP or SEREP output 
Models 115/125 Log 
analysis displays 
Model 158 display frames 
Loop traces 



PROGRAMMERS 





Program logic 



Error messages 
and Dumps 



Figure 1-1 . The four phases of debugging 



Phase 3 ■ 



Isolate the error: 

Error messages 
JCL errors 
Incorrect macros 
Linkage editor errors 
Source code errors 
Loop traces 
I/O data file errors 
Flowcharting errors 



* 



Phase 4 



Further error isolation: 

Trace routines 

Operator's console 

Supervisor communication 

macros 

Library and Service programs 
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Generally speaking, a system malfunction is said to have occurred whenever a 
program did not do what it was expected to do. A system malfunction can be 
due to one or more of the following: 



An operator error or job set (JCL) 

An error in the program logic, a coding error, or 

the misuse of instructions 

A hardware failure 

An unusual circumstance during program execution. 



Because of the many circumstances in which errors may occur, system malfunctions 
manifest themselves in different ways. 

The physical size of a given system, its environment, and the type of programs used 
also play a part in how a particular error affects system operation. 



During single-partition batch jobs (BJ) 

In this type of environment, the easiest way to recover from an error is to cancel 
the job and begin it again from the IPL procedure. However, to deal with a 
program that has been operating successfully for several hours prior to the error, 
alternative methods must be used. 

Also in this type of environment, operators "get to know" the programs and can 
recognize when the programs do not appear to be performing the same as before. 
Hands-on debugging can be performed without interfering with the execution 
of other jobs. 



Multiprogramming environment (MPS) 

To cancel, re-IPL, and restart jobs after a malfunction in this type of environment 
would delay both production and debugging procedures. Hands-on debugging is 
more difficult than with BJ, and the method used to gather information must be 
carefully chosen. It is also impossible to "get to know," by repeated use of the 
same programs, exactly what each job should be doing at any given time, and so it 
is more difficult to recognize a system malfunction. 



Teleprocessing (TP) 

Since teleprocessing is normally executed on multi-programming systems, the 
same problems are met as those described under MPS. Additionally, the 
cancellation of jobs is more difficult. The difficulty increases in proportion to the 
number of terminals online, and the number of active partitions, when the mal- 
function occurred. Hands-on debugging cannot be attempted without informing 
and affecting all the terminals. 



During program testing 

Although systems may not be large or complex in this type of environment, it is 
less likely that the operator will know the programs. In this environment, the 
testing of new programs and the simulation of space flights, aircraft structures, 
traffic controls systems, etc., are carried out daily, with unpredictable results in 
most cases. Hands-on debugging can be done only by the programmer. Even 
recognizing a system malfunction is in itself difficult. Gathering the right 
information is of paramount importance, to enable the programmer to debug 
offline. 

The previous paragraphs indicate that when a system malfunction occurs, the 
operator must be able to recognize it as such, decide on whether or not to use 
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hands-on debugging to make a possible recovery, and decide on the best method of 
gathering information that will help the programmer. 

A description follows of the main types of system malfunctions, how to recognize 
them, and how to treat them. 
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Type of Malfunctions 

LOOPS Definition 



A loop in a program is the repetitive execution of a sequence of CPU (central 
processing unit) instructions. 

If the number of instructions in the loop is small, the loop is referred to as being 
small, short, or tight. When a loop consists of many instructions, which may also 
include input/output operations, the loop is often referred to as long. 

Types of loops 

A part of a program may be repeated a number of times, thus creating a programmed 
loop. A programmed loop is often referred to as a processing loop. Sometimes a 
program error causes the CPU to repeat part of a program endlessly. Such a loop is 
never intended and requires debugging procedures to isolate the error. 

Recognizing a loop 

One or more of the following may indicate that a job/program is in an unintended 
loop: 

• A steady glow of lights on the system Models 1 1 5 , 1 25 , and 1 58 , control 
panel with the SYS indicator on, or for the System/370 one address will appear 
to remain displayed on the video display unit. (This depends on whether the 
loop is long or short.) 

• A rhythmic pattern in the lights on the system control panel, or for the 
Models 115, 125, and 158, the word WAIT may flicker on the video display 
unit. 

• A pointless recurrence of I/O (input/output) activity. 

• A job (program) that does not change status for a long time (for example, an 
absence of I/O activity). 

A note to the operator: When a loop is recognized, the operator must first try to 
establish whether the loop is unintended or has been programmed, before beginning 
with hands-on debugging. 

If the programmer has not warned the operator about a programmed loop, or given 
a time estimate for the program, it will be very difficult to differentiate between 
an unintended loop and a programmed loop. 

Even when time estimates are given, job or program time may increase because of 
any one or more of the following: 

• Priority of the partition in which the job is running (multiprogramming 
system) 

• CPU retry and error logging routines 

• The use of slower speed input/output units than those for which the job was 
originally planned. 

Causes of an unintended loop 

• A coding or logic error in the program may cause an unintended loop. 

• The operator may have set the job up incorrectly, thus causing the program 
to loop at some stage during execution. 

• An input/output device malfunction. 

• A JCL (job control language) error. 
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Operator action LOOPS 

If the operator is not sure whether the loop is unintended, the programmer must 
be contacted before any debugging procedures can begin. If this is not possible, 
the only action the operator can take is to let the job run on for a time, depending 
on system commitments, and to make notes of any further system activity. If the 
loop is programmed, no time would have been lost by allowing it to run on. In 
multiprogramming environments a loop in one partition will affect the run times 
of programs in other partitions. 

Flowcharts in Section 3 will help the operator in gathering information at the 
time the error occurs, and Section 4 provides a guide for programmers in how to 
analyze this information. 
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WAIT STATES 



Definition 

There are occasions when an error in the program or the machine causes the 
system to stop. This means that no I/O activity is occurring and no instructions 
are being executed. 

In this state the hardware circuitry turns on the WAIT indicator, or on the 
System/370 Models 115, 125, and 158, displays the word WAIT on the video 
display unit, and the system is said to be in a wait state. 



Types of wait states 

The impact of a wait state on system operation depends on the cause of the wait 
and the operator action required to recover from it. The following terminology 
is used for describing a wait state: 



Hard wait 
Soft wait 
Normal wait 



Essentially, the difference between the first two waits is that the system 
recovery from a hard wait is impossible without executing a system IPL, whereas 
recovery from a soft wait may be accomplished without impairing program or 
system operation. The operator can easily determine the type of wait state by 
pressing the REQUEST key. If the wait is soft the following message may be 
issued: 

AR 1I60A READY FOR COMMUNICATIONS 



When the system is waiting for operator response to a message printed on the 
console printer or for an I/O device to be made ready by operator action, 
the wait state is sometimes referred to as normal. 



Recognizing a Wait State 

Any of the following observations confirm that the System is in a wait state: 

• WAIT indicator remains on, or for a System/370 Models 115, 125, and 158, 
the word WAIT remains displayed on the video display unit. 

• SYS indicator remains off (See Figure 1-2). 

• No I/O device activity occurs. 

• One or more SYSTEM CHECK indicators are on. 

• A HARD MACHINE CHECK message is printed on the console printer. 

• A HARD WAIT coded message in general register 1 1 (X'B'). 

• A HARD WAIT coded message in bytes 0-3 of low address storage. 
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Causes of a soft wait 

A soft wait may be the result of an I/O operation performed on a malfunctioning 
device that is unable to complete an operation. 

A system waiting for a magnetic tape unit to rewind a tape reel or for a disk unit 
to finish a seek before continuing a program, is in a temporary soft wait. 
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WAIT STATES 



Recovery from a soft wait 

If the system is in a soft wait, it is waiting for an interrupt to signal the completion 
of an event. Although the expected interrupt may be from the timer or external 
interrupt key, a missing "device-end" caused by hardware is the most frequent 
cause. The operator can make each device not-ready, then ready ■ to generate a 
device -end interrupt from each device. The system light flashes briefly as the 
supervisor examines and discards interrupts for which it was not waiting. The 
interrupt from the device for which the system is waiting causes normal processing 
to continue. (The occurrence should be brought to the attention of the customer 
engineer as a possible hardware failure.) 

It may be possible to isolate the cause of the wait and take alternative action, such 
as using a different I/O device. 

Recovery from a wait state becomes more important on large online multi- 
programming systems where to cancel programs or to re-IPL may be disastrous. 



Causes of a hard wait 

Hard waits can be caused by machine failure and programming errors. Possible 
programming errors that cause hard waits are : 

• Supervisors errors as the result of a program check while in the supervisor 
state 

• Coding errors in transient routines 

• Incorrect use of transient routines. 



Operator action 

If the hard wait has been caused by a hard machine check shown by a message on 
SYSLOG and/or a coded message in bytes 0-3 of low address storage (see note), 
the operator must gather information from the system to help the IBM customer 
engineer locate the error. 

If, however, there is no indication that the wait has been caused by a hard 
machine check, some information as to the cause of the wait can be obtained 
before retrying the job or starting a new one. 

In any case certain initial checks must be made on the setup procedures for the 
job, the input media in use, and I/O devices in use. 

Flowcharts in Section 3 will help operators in carrying out initial system checks 
and in gathering data about the wait state, and Section 4 provides a guide for 
programmers in how to analyze the data. 

Note: For the Models 115 and 125 that are not supporting MCAR/CCH, a coded 
message is placed in GR11. A complete list of coded messages is given in Section 2. 
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INDICATORS FOR 
LOOPS AND 
WAIT STATES 



The SYS, MAN, and WAIT indicators show the CPU and 
I/O operating states as follows: 



1. 


a e 


■ Model dependent 
1 control console 
1 layout 


2)@©©©(2)® 

BQ B (50088 B 



loooool 



INDICATOR 


FUNCTION 


SYS* 


The SYSTEM indicator is on when CPU operations are 
in progress and either use meter is running. 


MAN * 


The MANUAL indicator is on when the CPU clock is 
stopped or the system is in a stop state. All pending 
interrupts are handled. Manual store/display operations 
are possible only when the MANUAL indicator is on. 


WAIT * 


The WAIT indicator is on when the system is in a wait state 
(CPU clock running but no instruction processing taking 
place). If the wait is a soft wait state and an interrupt 
occurs, the CPU is taken out of wait state and processing 
started under control of the program being executed. 



* These indicators do not exist on System/370 Models 115, 
125, and 158. Instead the corresponding words are displayed 
on the display unit. 
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Figure 1*2. System indicators. 

Aids for recognizing a loop or a wait state. 
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Definition INCORRECT 

* • u • , OUTPUT 

Incorrect output can range from incorrect line spacing on the printed output 

from a line printer to incorrect results of calculation written on a disk file. 

Recognizing incorrect output 

Incorrect output may be detected by: 

1 . Operator 

• Invalid messages "^ Ton console printer(s) 

• Unidentified data >■ -l line printer(s) 

• Duplication of data J I display unit(s) 

• Lack of activity on I/O devices assigned as output units 

• Either more or less I/O activity than expected. 

2. Programmer 

If the execution of a program has been apparently successful, incorrect results 
will not be detected until the data is used at some future time . 
Incorrect output can be categorized as: 

• Missing records 

• Duplicate records 

• Invalid data that has sequence errors, incorrect values, format errors, or 
meaningless information. 

Causes of incorrect output 

As well as errors in the program logic, mistakes in setting up the system for the 
program will cause errors in the output. For example, use of incorrect data for 
input files, mistakes in device assignments, and incorrect job control statements and 
commands in the job stream will cause unexpected output. 

Operator action 

If the programmer cannot be contacted, the operator must save the output (what- 
ever it is) or make a note of system activity before cancelling the job, or both. 

The work files and input data should be given to the programmer together with 
any dumps executed. It may also be necessary to re-submit the job and trace the 
logic flow by using the SDAID BR and/or IF trace. 

Flowcharts in Section 3 and 4 indicate the serviceability aid to use for isolating the 
cause of this type of system malfunction. 
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INTERMITTENT 
ERRORS 



Definition 

An error which occurs once and then seems not to recur for some time, is said 
to be intermittent. The frequency of the error may be a fraction of a second in 
the case of a high-speed computer like the System/370, or a week, a month, a year, 
or even longer. Intermittent errors can be caused by hardware failures or by 
programming errors. 



Hardware failures 

IBM provides serviceability aids that record and analyze hardware failures and 
attempt to recover from them. The routines that perform these functions are 
collectively termed RMS (Recovery Management Support). If online recovery is 
impossible, the system may be placed in a hard wait state. A message is issued to 
the system operator to run either the SEREP or EREP program. The output 
obtained from either of these programs is a listing of the statistical data accumu- 
lated up to and including the time of the error. This information serves not only as 
an aid in diagnosing machine errors, but also helps IBM customer engineers to 
increase the Reliability, Availability, and Serviceability (RAS) of the system. 

RMS does not affect system operation, except for the time required to record the 
failure and issue an informatory message on SYSLOG. 

• Note: By use of the MODE command the recording and printing of soft 
machine checks can be suppressed. (This is not applicable to the 
Models 115 and 125). 

If the retry of an error is not successful and the severity of the error prevents 
system operation, the machine attempts to issue the message 

0T1 1W HARD WAIT CODE = X (where X is an alpha character A thru I) 
and the system is placed in a hard wait state. Diagnosing this condition is described 
in Sections 2 and 3. 

On the System/370 Models 1 15 and 125 statistical data about the hardware is 
recorded on the DISKETTE by micro-program. The recorded data on the DISKETTE 
can be displayed on the video display unit by selecting one of the LOG ANALYSIS 
displays. This is described more fully in Section 2 — F in this manual. The 
information displayed supplements the EREP/SEREP program output that may 
also be required, depending on the type of I/O units attached to the systems. If 
a hard wait occurs with no message on the console printer, there may be a message 
in "low address storage" that will indicate an operator action. Low address 
storage and its meaning is fully discussed in Section 2. 



1.14 Introduction 



Intermittent programming errors 

After writing a program, it is in most cases quite impossible to test it under all 
combinations of circumstances that may occur during its use. Therefore, 
programs may contain coding errors that become evident only under particular 
circumstances, even after years of error-free use. 

Since the error does not occur every time the program is executed, and the EREP 
printout or Log Analysis display indicates no hardware failures, this type of 
system malfunction is regarded as an intermittent software error. 

Such an error can be caused by a combination of the following: 

• A change in the input data (a new card deck) 

• Poor quality input media (cards, tape, data transmission) 

• An existing coding error in a routine that is not normally executed 

• A change of routines called by the supervisor 

• The use of a new software routine 

• New operating procedures 

• Changes in the job control language. 

An error of this type is difficult to isolate, and requires the use of special 
debugging techniques. 



Definition 

There are three types of program check interrupts: 

1 . A page translation exception. This occurs when an instruction or data is not 
in the real address area. A page from the page data set must be 'paged in' to 
the real address area before the program can continue. This is not an error 
condition. 

2. Program check interrupt resulting from the use of the MC (monitor call) 
instruction. This is not an error condition. 

3. Program check interrupt resulting from incorrect specification or use of an 
instruction or data by the problem program. This is an error condition, and is 
always reported by a message issued on SYSLOG at the time of the program 
check as shown below: 
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PROGRAM CHECK 
INTERRUPT 



BG 0S03I PROGRAM CHECK INTERRUPTION - HEX LOCATION 0406E0 - 
CONDITION CODE 3- DATA EXCEPTION 
0S00I JOB DEBUGEXS CANCELED 

The program is automatically cancelled by the supervisor and depending on the 
use of the job control statement / / OPTION DUMP, or the DUMP option being 
supported by the supervisor, a dump of the supervisor and of the partition owning 
the program is executed. This automatic program cancellation is termed abnormal 
EOJ (end of job), or program abnormal end. The program check message gives 
the location of the failing operation and the condition code. This gives the pro- 
grammer a starting point for offline program debugging. 



Causes of a program check 

The most probable cause is improper specification or incorrect use of instructions 
or data in the program. 

Program checks occur most frequently during program testing, because of 
incorrect coding or errors in the program logic. 



Operator action 

No action can be taken by the operator other than saving for the programmer the 
console printer log sheet, the dump (if executed), job stream, and any input 
data files used by the failing program. Flowcharts in Section 4 will help the 
programmer to analyze the information and isolate the error. 
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I/O DEVICE 
MALFUNCTIONS 



A device malfunction either will be seen immediately as an incorrect physical 
operation, or will cause the system to enter a wait state, loop, or produce 
incorrect output as already discussed. Normally an error message will be 
issued on SYSLOG. 



Examples of device malfunctions 

Some obvious device malfunctions are: 

• Mechanical noises not normally present 

• Lamps either on or off which the operator recognizes as not normal conditions 

• A lack of movement of input/output media which the operator knows to be 
incorrect at the time 

• "Tape Runaway," a special type of error that occurs on magnetic tape drive unit 
(A mounted tape winds forwards at a higher speed than normal.) 

• Incorrect "form skipping" on the line printer. 



Operator action 

If there is no obvious action that can be taken such as pressing the device STOP 
and/or OFF buttons, consult the device component manual before informing 
your IBM customer engineer (unless the nature of the malfunction constitutes 
a danger to human lives and equipment). 
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When a system malfunction is recognized it is important that the operator obtain 
information from the system. The information helps the programmer and the IBM 
customer engineer during offline program debugging. Whatever the system mal- 
function, the operator must always save error messages issued on SYSLOG and/or 
on SYSLST, and in some cases save the I/O media (card files). 

The operator can obtain information by doing one or more of the following: 

• Issue the MAP command. 

• Make a note of system activity. 

• Display low address storage, the current PSW, the control registers and 
general registers. 

• Execute a storage dump. 

• Take a trace of a loop. 

• On the Models 135, 145, 155-11, and 158, initiate the EREP or SEREP 
programs 

• On the Models 115 and 125 on the advice of the IBM CE use the Log 
Analysis to display hardware errors recorded on the DISKETTE, 
and on the Model 158 use the display frames. 

Many factors must be considered when gathering information, and Section 3 and 4 
cover this subject in detail. 
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Gathering Information 



LOW ADDRESS 
STORAGE 



This area of low real storage (as defined in the Introduction to DOS/VS) is one of 
the important sources of system information used to aid offline program debugging. 
The contents of the low address storage can be dumped (printed out) or displayed 
by using job control commands or console aids. Details about the format and 
contents of the low address storage are given in Section 2-E of this manual. 
Figure 1-3 illustrates the location of low address storage in relation to other areas 
in virtual storage. 



Wait state messages 

PSWs 

CAW 
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PROGRAM A 


PROGRAM B 


PROGRAM C 


PROGRAM D 


PROGRAM E 
HIGH ADDRESS STORAGE 



Figure 1-3. Relative location of low address storage. 

Low address storage contains information to aid offline debugging. 
(Size relationships in this figure are purely illustrative.) 
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A dump is a program or an operation that prints the image, in hexadecimal format, 
of a selected area of virtual storage. This term is also used when an area of virtual 
storage is recorded or stored on magnetic tape of disk pack. 

Figure 1 -4 illustrates the various type of dumps offered by IBM. Section 2- A of 
this manual describes how to execute the dump programs and operations, and 
discusses the meaning of dump output that is useful during offline program 
debugging. 
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DUMPS 
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A dump or display of the 
low address storage. 

Attention routine commands 
and operator's console. 



A dump of a partition in the 
real or virtual address area. 
This is referred to as a 
Partition dump or a System 
dump and includes a dump of 
the supervisor area. 
System generation option, 
job control statement, job 
control command, and 
assembly macros. 



A snap shot dump used to 
display small parts of a 
program at any selected 
area. 

Attention routine commands and 
assembly language macros. 



A dump of the SVA 

Partition dump or a System 
dump includes a dump of 
the SVA (or part of it) if 
a program check occurs 
in the SVA. 



Figure 1-4. Storage dumps. 

Various areas of storage can be dumped or displayed using the IBM dump 
programs and console aids. 

(The dividing point between real and virtual address areas depends on the size 
of the hardware memory on your System/370). 
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LOOP TRACING 



Three methods of tracing or recording the path of a loop are provided on the 
System/370: 

1 . By using the facilities provided by the operator's console, the operator can 
list the addresses of the instructions used by the loop. 

2. By using the successful branch routine of the SDAIDS. 

3. By using the instruction fetch trace of the SDAIDS. 

All three methods are described in Section 2. The first method is useful to trace 
small loops during hands-on debugging. However, the amount of time that may be 
spent tracing a loop by this method depends on the answer to the following: 

1. How important is it to system operation that the loop be fully traced? 

2. How will the time spent tracing the loop affect system commitments? 
Normally the operator is not in a position to answer these questions and if the 
programmer or the DP manager is not available, he can only take a short trace. 
The second and third methods can be used either during hands-on debugging, or 
during re-runs of the program generating the loop. 



A note to operators 

Before tracing a loop by using any of the above methods, you must consider their 
effects on time-dependent programs currently running in the system. Such 
programs are, for example, those using magnetic ink character recognition or 
teleprocessing equipment as input/output devices. 

Guidelines on how to isolate an unintended loop and trace it are given in 
flowcharts in Sections 2 and 3. 
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RMS (Recovery Management Support) HARDWARE ERROR 

RECORDING AND 
The functions employed in recording a hardware error and recovering from it are RECO VE R Y 

collectively termed RMS (Recovery Management Support). RMS was introduced 
under "Hardware failures" in this Section. RMS software routines record hardware 
failures on the system recorder file, located on SYSREC (SYSREC can be either 
an area on SYSRES, or an individual disk pack.) 

For the System/370 Models 1 15 and 125, errors in the CPU and natively attached 
input/output devices (except tape units and teleprocessing terminals), are recorded 
on the DISKETTE. Recording is performed by microprograms and is independent of 
the RMS software routines. 

Figure 1-5 contains an overview of RMS, which is a part of the total RAS 
(Reliability, Availability, and Serviceability) concept. RMS uses a monitor and 
several transient routines that check the severity of the error, record it (if possible), 
and print informatory messages. 

Using an IBM program called EREP (Environmental Recording, Editing, and 
Printing) the data on the recorder file can be printed on a line printer. This data 
is used to investigate the nature and cause of a system malfunction. For the 
Models 1 15 and 125 , information will be printed by EREP only if the system 
supports RMS. (Refer to Section 2-F for details.) 

If the severity of a hardware error is such that EREP can not be executed, the IBM- 
supplied program SEREP must be executed. SEREP is a stand-alone version of 
EREP that formats and prints the data held in the logout areas of real storage. 

On the System/370 Models 1 1 5 and 1 25 , the LOG ANALYSIS displays hardware 
statistical data recorded on the DISKETTE. This is additional to the EREP program 
that can be executed after using the log analysis displays. 

A similar facility is provided on the Model 1 58 in the form display frames obtained 
by the use of the SERVICE function. 

How to execute EREP and SEREP, and how to use the log analysis displays and 
display frames feature is described in Section 2. The components of RMS are fully 
described in Section 2-F. 
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HARDWARE ERROR 
RECORDING AND 
RECOVERY 



Hardware error 



Error detection, correction, and 
recovery by hardware microprogram 



Machine check interrupt 
generated for CPU error, 
main storage and control 
storage errors. 



I/O interrupt generated 
for I/O channel and device 
errors. 




No 



For System/370, Model 115/125 
record error on DISKETTE and 
SYSREC. For Models 135, 145, 
1 55-1 1 , and 1 58, log error in 
the LOGOUT areas of real storage. 
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(depends on severity of error) 
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^ ^ possible 



Automatic system action 



Records data about the error 
on the system recorder file. 



Cancels the job in which 

the error occurred. 

Prints a message on SYS LOG 

to inform the operator of 

system action. 

Continues processing with 

next job. 



Records data about the 
error on the system 
recorder file. 



• Prints a message on SYSLOG 
to inform operator that a 
hardware error has occurred. 

• Continues normal processing. 



Operator action 



For use by IBM 
customer engineers 
during scheduled 
maintenance 



For System/370, Models 1 15 and 
125, use the LOG ANALYSIS 
feature to display hardware 
statistical data and for Model 158 
use the display frames 



Figure 1-5. An overview of RMS. 

This illustration shows the general connection 
between the hardware and software components of the 
hardware error recording and recovery functions. It 
also shows the connection between RMS and the 
EREP and LOG ANALYSIS programs. 



f 



± 



Use EREP to print out 
the data about hardware 
errors recorded on the 
system recorder file. 



Programmer action 



} 



IBM customer engineer's action 



Use the EREP printout to 
find out more about the 
system. 



Use EREP printouts to aid 
in hardware error diagnosis 
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Gathering Information 

EREP (Environmental Recording, Editing, and Printing) HARDWARE ERROR 

RECORDING AND 
This program edits and prints information about hardware failures that are RECOVERY 

recorded on the system recorder file (SYSREC). 

There are several options of EREP that enable the operator to select SYSREC 
records for editing and printing. These options are detailed in Section 2. By using 
the EREP program output, the IBM customer engineer can recognize hardware 
failures. During scheduled maintenance periods he can then perform preventive 
maintenance on the parts of the system causing hardware failures. 

Because the EREP program can be initiated by the operator, it is a useful aid for 
gathering data about the condition of the hardware at any time during 
system operation. 

Some messages issued on SYSLOG tell the operator when to execute EREP. 
For example: 

0T1 1W HARD WAIT CODE = D 

RUN EREP RECORDING SUCCESSFUL 

Other occasions when EREP should be executed are indicated in DOS/VS 

Messages. 

For example: 

0T05E ERROR ON RECORDER FILE - RUN EREP 
Operator action: 
Schedule the EREP program to display the information on SYSREC. 

Either the operator action listed under the appropriate message will indicate 
the EREP option to select, or your IBM customer engineer will advise you on the 
option to select. 

Flowcharts in Sections 3 and 4 also indicate when to execute EREP. 
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SEREP (Stand-alone EREP) 

This is a stand-alone program that edits and prints hardware failure data either 
stored in the logout area of real storage or, for the Model 158, recorded on the log 
recording console file. 

SEREP provides a means of printing system status information stored in the real 
storage logout areas at the time of the machine malfunction. The SEREP 
printout is analyzed by your IBM customer engineer. 

For the Models 135, 145, and 155-1 1 , SEREP is initiated using the standard IPL 
procedure. The SEREP program consists of a card deck and must be executed 
when the message issued on SYSLOG indicates "RUN SEREP." 
For example: 

0T1 1W HARD WAIT CODE = H 

RUN SEREP RECORDING UNSUCCESSFUL 

For the model 158 SEREP is contained on the Log Recording Console File which 
is loaded by using the Service and Index frames. 

If a hard wait condition occurs and no message is printed, a wait message in low 
address storage will inform the operator if SEREP is to be initiated. 

Flowcharts in Sections 2 and 3 indicate how and when to use SEREP. 
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Log Analysis Displays (Models 115 and 125) 

This aid, provided for IBM CE use, enables the condition of the internal hardware 
to be displayed, and, if required for offline analysis, to be printed on the 521 3 
printer, if attached. On advice from the CE, an operator is able to obtain "hard 
copies" of the displays if a hardware error is the cause of a system malfunction. 

Maintenance (M) 

When the mode selection display is on the video screen and the operator enters 

selector character 'M' against 'Mode Specification,' the screen displays the 

maintenance repertoire. This repertoire consists of log analysis, micro tests, and 

CE manual operations, as shown in the figure below. The cursor is positioned next 

to the preselected 'M' so that any one of the maintenance modes can be 

selected. 



Gathering Information 

HARDWARE ERROR 

RECORDING AND 

RECOVERY 



* MAINTENANCE PROGRAM SELECTION 



LC 


)G 


TESTS 


CE 


-MAN.CPS 


A 


= LOG GENERAL 


J =CPU 


S = 


I OP 


B 


= CPU 


K= 1403 


U = 


CRT-SCOPE 


c 


= CARD/PRINT I/O 


L = 2560/5425 


V = 


l/OEXERS 


D 


= DISK 


M= 3504/3525 


X = 


IPU 


E 


= ICA 


N = DISK 


Y = 


MATRIX S 


1 


= CHANG. DISKETTE 


0= ICA 


Z = 


MATRIX M 



PROGRAM SELECTION: M R = SYSTEM TEST (ASCP) 




Note: E = ICA is displayed only when the system supports the Integrated 
Communications Adapter 

Figure 1-6. Model 125 maintenance program selection display. 

On the Model 115 the entry M - 3540/3525 and entry K = 3203/5203 

Log Analysis (A-E) 

When a parameter 'A' through 'E' is entered into the maintenance display, log 
information is brought to the screen. Entering 'A' for instance, causes a display of 
general log information that informs the operator if any logging occurred, and if 
so, which part of the system caused it. From this report, the operator can select 
a detailed log by keying in one of the four characters 'B' through 'E'. For example, 
'B' provides log information for the CPU. 

A "hard copy" printout of the displayed information can be obtained and saved 
for your IBM customer engineer by pressing the copy key, if a 5213 matrix printer 
is attached to your system. 

Further details are given in Section 2, F-5. 
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Display Frames (Model 158 only) 

A serviceability aid provided on the Model 158 allows the operator to display and 
obtain "hard copies" (on the 3213 printer) of the condition of the hardware. 

The information displayed or printed is used by the IBM CE to diagnose the cause 
of a permanent hardware error. A hardware error of this type will be recognised 
by the operator by an error message displayed on the program frame, for example 
the words STOR CHECK displayed in the lower right corner of the frames. 

Having recognized the existence of a hardware error, the operator can either inform 
the IBM CE immediately, or can "look at the hardware" by scanning the information 
on the display frames and obtaining a "hard copy" of them if desired. 

The type of information displayed is listed under numbers 6 to 26 in the INDEX 
frame shown below. 



21-CPU CHECKS&RETRY 



23-CHANNEL CHECKS1 
24-CHANNEL CHECKS2 



-EXTERNAL DIAGNOSTICS 



1-CHANNEL DISPLAY 
1-CHANNEL 1 DISPLAY 



-CHANNEL 2 DISPLAY 



3-CHANNEL 4 DISPLAY 



S-SCU DATA ELOI/V1 



-CHANNEL TO CHANNEL 
i-EXECUTION ARRAY 



COMPOSE- "START "STOP "CLEAR 



Figure 1-7. The Model 158 Index Frame 

This frame is obtained via the manual and service frames. With this additional information 
about the hardware, the IBM CE will be able to advise on further system operation. 
How to use this serviceability aid is described in Section 2-F. 
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Further Error Isolation 



If the error cannot be isolated by analyzing the information obtained from the 
procedures already mentioned, other programs and tools must be employed during 
program reruns. 



Trace routines 

The trace routines supplied by IBM are special programs that "look inside" the 
central processing unit during system operation. 

Traces of program execution are especially valuable on the larger multiprogramming 

systems. 

Traces can indicate the phases used, the supervisor calls required, the types of 
interrupts encountered, and the I/O activity during program execution. Trace 
routines can also indicate paging activity and successful branching, and produce a 
printout of instructions fetched, and storage and general register alterations, 
during program execution. 



Supervisor communication macros 

Certain DOS/VS macros can be written into programs to provide more information 
about the state of the system at the time of an error. One such macro is PDUMP, 
which will give a dump of any specified real or virtual address area. 



Operator's console 

A useful tool for hands-on debugging is the operator's console. This is used for 
"tracing a loop" and displaying or altering registers and small areas of storage. 



Library and Service programs 

DOS/VS library and service programs are useful when information is required 
about previously written programs that are used by problem programs. These 
DOS/VS programs will list volume directories, print listings of the programs 
contained in the libraries, and display file label information. Such information 
is required, for instance if a particular phase on a private core image library causes 
incorrect results of calculations when used by one of the tested problem programs. 



VSAM Programming Aids 

VSAM (Virtual Storage Access Method) provides aids that print, list, and 
verify data recorded on VSAM files. Assembler macro instructions for VSAM 
are also provided to allow the programmer to obtain information about I/O 
operations (OPEN, GET, PUT, CLOSE) during execution of VSAM programs. 
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Analyzing the. information 



The analysis to be made depends on when the job failed and how much pertinent 
information the operator obtained from the system at the time of failure. It also 
depends a great deal on the system environment. The first step is to examine 
messages printed on the console log sheet, and to look for any messages on the 
output printer. 

The next step is to examine any other printed output, for instance , program output 
and storage dumps. 

For a successful analysis, the programmer, who should be familiar with the 
program, will require: 

• The program listings 

• The linkage editor map 

• Flowcharts of the failing program. 

In the more difficult cases of program errors, the programmer will also require: 

• The supervisor listing 

• Output of the trace routines 

• Dumps of the data input files 

• The input media 

• Listings (or displays) of file label information 

• Listings (or displays) of the libraries. 

If the program failure was caused by a hard wait, the programmer should scan the 
EREP printout (if one was obtained) to eliminate any possibility of a hardware 
failure, and examine the stand-alone dump. 

Section 4 describes in detail how to use the above l.sted output during offline 
debugging. 



Introduction 



1.28 



DOS/VS Serviceability Aids and Debugging Procedures 

SECTION 2 



SERVICEABILITY AIDS 



2.1 



Section 2 

SERVICEABILITY AIDS 



How to use this section. 

Familiarize yourself with the contents of this section, which gives details about 
the operation and execution of the serviceability aids offered by IBM. 

The reference chart shown on the opposite page lists the aids described in this 
section in groups according to type. 

All right-hand pages in this section have running-tabs numbered to correspond to 
this chart. The chart helps you to locate details about any aid described in this 
section. 

For example: 

SEREP is described on page marked F — 4 

Another example: 

When a dump of the low address storage is required in an operators flowchart of 

Section 2 and 3 it is indicated as: 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



See D-1-F for Models 135, 145, 155-1 1 
and D-2-F for Models 115, 125 
and D-3-F for Model 158 



D-I-F, D-2-F and D-3-F refer to tab numbers that identify unique pages in this 
section. 

In this example it guides the operator to the flowchart procedure for dumping 
low address storage. 



Table referencing in this Section 

Illustrations in this Section do not have figure numbers, but are referenced by the 

text. For example, "the next illustration shows " or "the figure on the 

opposite page shows the ". 

However, because tables in this section are often referenced from other parts 
of this manual the tab referencing system is used for the Tables. For example: 
A table in sub-section B-6 is given the reference of B-6. If there is more than 
one table in any sub -section the first table is given the reference B-6-A and the 
second table B-6-B, and so on. 



2.2 Serviceability Aids. 



Section 2 



SERVICEABILITY AIDS 



Dumps of, and 
changes to the 
real and virtual 
address areas 



Operator 

commands 

ALTER 

DISPLAY 

DUMP 

System 
dump 



DUMPGEN 
and the stand- 
alone dump 
program 

Transient dump 



5 Supervisor 
communication 
macros 



VISUAL INDEX 




10 



11 



Library display 
programs and 
utilities 



PART1 PDAIDS 
Introduction, 
system 

requirements, and 
terminating 

PDAIDS 
Description, 
operation, and 
examples 

The PD area 



Initializing 
PDAIDS 



PDAID 
Job stream 
examples. 



PART 2 SDAIDS 
Introduction, 
System 
requirements, 
terminating, and 
output information 

SDAIDS 
Description 
and operation 

SDAIDS 
Stop and 
dump 
routines 



The SD area 



LSERV 



Library display 
programs 



ESERV 



VTOC 

display program 



Reserved for 
future use 



SYSVIS 
dump Utility 



Initializing 
SDAIDS 



Examples of 
SDAID job entry 
and output 



Hardware aids 
through the 
operator's 
console 



10 



11 



Other aids 



ALTER/DISPLAY 
Models 135, 145 
and 1 55-1 1 



ALTER/DISPLAY 
Models 115 and 
125 



ALTER/DISPLAY 
Model 158 



Instruction 
stepping 

Models 135, 145 
and 1 55-1 1 



Instruction 
stepping 
Models 115 and 
125 

Instruction 
stepping 
Model 158 



Stop on address 
Models 1 35, 1 45 
and 1 55-1 1 

Stop on address 
Models 115 and 
125 



Stop on address 
Model 1 58 

Models 115 and 125 
Console dump 
operation 

Store status and 
clear real storage 
(all Models), and 
Save Usage Counters 
(Models 115 and 125 
only) 



Job control 
commands and 
statements 



Low address 
storage 



Wait state 
messages 



Linkage Editor 
Map 



Hardware error 
recovery and 
recording 



Recovery 
Management 
Support 
(A general 
description) 

Recovery 
Management 
Support 
(A detailed 
description) 

EREP 



SEREP 



Maintenance 
Log Analysis 
Models 115 
and 125 

Display frames 
(Model 158 only) 



OLTEP 
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Intentionally Blank 



2.4 Serviceability Aids. 
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Dumps of, and changes to Real and Virtual Address Areas 



OPERATOR COMMANDS 
(ALTER) 



The ALTER Command 

To activate the ALTER command press the REQUEST key and enter ALTER. The 
command is used to alter from 1 to 16 bytes of virtual storage starting at the 
specified address. 



Operation 


Operand 


ALTER 


xxxxxx 



The operand xxxxxx is a six-digit hexadecimal address. Six digits must be 
entered regardless of the size of the address; addresses of less than six digits must 
be preceded by zeros. 

After the command has been entered and the END key pressed, the hexadecimal 
representation of the information to be placed in storage should be entered. Two 
hexadecimal characters (0 to F) must be entered for each byte to be changed. 
If an odd number of characters is entered, the last character is ignored and its 
associated byte is unaltered. 

Examples are shown below. 

















• 


AR 


1.IA0A READY FOR COMMUNICATIONS. 








AR 


alter 040820 








AR 


00622000 








• 


AR 


alter 000430 








AR 


:l. I42D ADDRESS WITHIN SUPERVISOR OR SVA 










AR 










• 


AR 


J.IAOA READY FOR COMMUNICATIONS. 








AR 


alter 0404 eO 










AR 


8a 800004 








• 


AR 




^^^^^^^****T 
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Dumps of, and changes to Real and Virtual Address Areas 

Restrictions OPERATOR COMMANDS 

1 . If the bytes to be altered cross the boundary from a valid to an invalid address ( A LIE R) 
space (see the third restriction, below), only the bytes in the valid address 

space are changed, and the following message is issued on SYSLOG: 

11471 XX BYTES COULD ONLY BE ALTERED 

2. If the highest available virtual storage address is exceeded before sixteen 
bytes are printed, the command is terminated and no alteration can occur. 

3. If the specified address is within an invalid address space, message 

1I41D INVALID ADDRESS 

is issued on SYSLOG. 

An INVALID ADDRESS is one of the following: 

• The address of a location in the gap between real and virtual 
address areas. 

• The address of a location beyond the end of virtual storage. 

• The address of a location in the page pool. 

• The address of a location in a virtual partition whose real partition 
contains a program running in real mode. 

4. Altering the Supervisor area or SVA 

If the address entered falls within the supervisor area or within the shared virtual 
area (SVA), a warning message is issued on SYSLOG: 

1I42D ADDRESS WITHIN SUPERVISOR OR SVA 

To respond to this message, press END/ENTER to terminate the ALTER 
command or reply with IGNORE to allow alteration. 

When to use 

This aid is primarily a hands-on debugging aid. The programmer can use it in 
conjunction with program listings to modify any part of the programs presently 
running in virtual storage. This enables immediate checks on results of 
program changes during execution of the program. 
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Dumps of, and changes to Real and Virtual Address Areas 



OPERATOR COMMANDS 
(DSPLY) 



The DISPLAY Command 

To activate the DSPLY command press the REQUEST key and enter DSPLY. The 
command allows the operator to display on the console printer keyboard 1 6 bytes 
of virtual storage starting at the specified hexadecimal address. Two hexadecimal 
characters (0 to F) are printed for each byte of information; these characters 
represent the hexadecimal equivalent of the current information in the virtual 
storage. 



Operation 


Operand 


DSPLY 


xxxxxx 



The operand xxxxxx is a six-digit hexadecimal address. Six digits must be 
entered regardless of the size of the address; addresses of less than six digits must 
be preceded by zeros. 

After the command is entered and the END/ENTER key is pressed, the hexadecimal 
representation (two characters for each byte) of sixteen bytes of virtual storage 
will be printed. 

Examples are shown below. 
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Dumps of, and changes to Real and Virtual Address Areas 



Restrictions 

1. If the sixteen bytes cross the boundary from a valid to an invalid address space 
(see the third restriction, below) only the bytes in the valid address space are 
displayed, and the following message is issued on SYSLOG: 

11481 XX BYTES COULD ONLY BE DISPLAYED 

2. If the highest available virtual storage address is exceeded before sixteen bytes 
are printed, the command is terminated. However, the contents of those 
bytes that fall within the virtual address area are printed. 

3. If the specified address is within an invalid address space the following message 
is issued on SYSLOG: 

1I41D INVALID ADDRESS 

The definition of invalid address space is listed under item three of "Restrictions" 
in the description of the ALTER command. 

When to use 

This aid can be used during hands-on debugging, or an operator can be 
instructed to use it at specific addresses in a program. 

For instance, loop count areas, small areas modified by loops, or parts of I/O 
areas can be dumped or displayed during program execution. The dump 
information will help during offline program debugging. 



OPERATOR COMMANDS 
(DSPLY) 
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Dumps of, and changes to Real and Virtual Address Areas 



OPERATOR COMMANDS 
(DUMP) 



The DUMP Command 

To activate the DUMP command press the REQUEST key and enter DUMP. The 
command allows the operator to display large areas of virtual storage on SYSLST. 
The SYSLST used may be assigned to any partition, but it must be a printer and it 
should not be in use by the partition. If the same printer is being used by the 
partition, the printed output will be a mixture of dump and partition output. 



Operation 


Operand 


DUMP 




S 

BG 

Fn 


|~(BGf 
[_(Fna*)_ 


* Note 1 






BGS 








FnS 








PDAREA 








xxxxxx, xxxxxx 













n,n' = 1,2,3,4 



Note: 



If the first operand is omitted, the general registers, control registers, and all 
storage that is currently used by programs, except that used by the supervisor 
(unless the operand BGS or FnS is specified), will be dumped. See note 2. The 
storage used consists of: 

1. Real storage not belonging to the page-pool 

2. The virtual partitions in which a program is currently running. 



Description of the operands: 



Operand 


Meaning 


S 


Causes a dump of storage used and the supervisor area. See note 2 


["] 


Causes a dump of the specified partition and its associated registers. 
If a real-mode program is running in the specified partition, the temporary 
real partition is dumped. If a virtual-mode program is executed in the 
specified partition, the whole virtual partition is dumped. 


rBGSl 
|_Fn S J 


Causes a dump of the same areas as described for the BG/Fn operand. 
However, the dump will include the supervisor area. 


PDAREA 


The PD area and the registers will be dumped (See Section 2, B-3 for 
details and a description of the PD area.) 


XXXXXX, 
XXXXXX 


Specifies the starting and ending address of virtual storage, with 
associated registers, that is to be printed. If the starting address is not on 
a f ullword boundary, the address is rounded down to the first fullword 
boundary; if the ending address is not on a fullword boundary, the 
address is rounded up to the first fullword boundary. A minimum of one 
fullword is dumped, beginning at the start address. 



Note 1: 



BG 
F1 

F2 H 
F3 
F4 



When any of these additional operands are specified, the area of virtual storage 
specified by the first operand is dumped on the SYSLST assigned to the partition 
specified by this operand. SYSLST must be a printer and should not be in use by its 
assigned partition. If the same printer is being used by the partition, the printed output 
will be a mixture of dump and partition output. 
v (If this operand is not specified, the SYSLST printer assigned to BG is used. See note 2.) 



Note 2: 



An indication is given on the dump output whether the dump includes storage areas 
considered to be invalid address spaces. 

The definition of invalid address spaces is listed under item three of Restrictions 
in the description of the ALTER command. 
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Dumps of, and changes to Real and Virtual Address Areas 



When to use 

This command is useful in circumstances similar to those described for the 
DSPLY command: to obtain information about I/O areas, or areas modified by 
loops or transients during program execution. The only difference between this 
command and DSPLY is in the size of the area that can be dumped. 



OPERATOR COMMANDS 
(DUMP) 



Note: Logical transient routines can not be checked because the LTA is used by 
the DUMP transient. The information in the LTA is therefore overwritten by 
the D UMP rou tine. 

An example is shown below of a dump of the PD area using the DUMP command, 
when SYSLST is assigned to a line printer. 




CR 0-7 
« 8-F 

POARFA 

009480 
0094A0 
0094C0 
0094E0 
009 500 
009520 
009 5*0 
009 560 
013580 
0095A0 
0095CO 
009 5E0 
009600 
009620 
009640 
009660 
009680 
0096A0 
009 6C0 
0096E0 
009700 
009720 
009740 
009760 
009780 
009760 
009 7C0 
009 7E0 
009800 
009820 
009 840 
009860 
009880 
009 8A0 
009 8C0 
009 8E0 
009900 
00992 
009940 
009 960 
009980 
009 9A0 
009 9C0 
0099E0 



804000EO 000OF60O FFFFFFFF FFFFFFFF 
0000=000 00000000 00000000 00030300 



00000000 00000000 00003000 00000000 
00300000 00000000 C2300000 00000200 



E3037EF3 
00003000 
FFFFFFFF 
FFFFF=80 
50C091C4 
47F 09384 
00004111 
58810020 
B0034f=0 
078A070A 
078A3501 
918B07=A 
001842A3 
47F09110 
00009666 
8AF33800 
8AF00000 
20000000 
00OE070C 
04000000 
000084 = 
FF00BAF0 
070=2 000 
OOOOOOOE 
00000400 
09620000 
OO0EFF00 
000E073F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 
09620000 
20000000 
E2400000 
08003000 
00000000 
00000962 
070:2000 
0000:240 
8AF0030O 
8AFOO00O 



F8F07000 
00004798 
FFFFFFFF 
800047AE 
58A00014 
95FFA002 
00005 8C0 
19AB4740 
910CBFB7 
49209038 
B00691C8 
58B091B8 
00029430 
58A1001C 
000099FC 
OOOOOOOE 
00000400 
096 20000 
20000000 
E 2 400000 
08000000 
00000000 
00000962 
070C2000 
0000E240 
8AF 00800 
8AF 00000 
20000000 
000E070C 
04000000 
00008AFO 
FF008AF0 
070F2000 
OOOOOOOE 
00000400 
09620000 
OOOEFFOO 
OOOE070F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 



000099FF 
00003AA4 
FFFFFFFF 
47F0915C 
48AOA040 
4783910C 
91C49120 
90FE41CB 
B0454770 
078A070A 
078A58BO 
44009068 
B002 912 
50A8000S 
C4E40400 
070F200O 
OOOOOOOE 
000004 00 
09620000 
OOOEFFOO 
000E070F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
000004 00 
09620000 
20000000 
E2400000 
08000000 
00000000 
0000096 2 
070C2000 
0000E240 
8AF00800 
8AFOOOO0 
20000000 
000E070C 
04000000 
00008AFO 
FF008AFO 
070F2000 
OOOOOOOE 



0000479C 
00031330 
3FDEFFFF 
58B091B8 
492AOOO0 
1BCC43CA 
1O0647E0 
004819AC 
900CD732 
492O903A 
91B841BB 
502B0002 
10064710 
9133B332 
30002330 
30300962 
070C2000 
3000E240 
8AF00800 
BAF0O30O 
20000300 
OOOE070C 
04000000 
00008AFO 
FF008AF0 
070F2000 
OOOOOOOE 
00000400 
09620330 
OOOEFFOO 
0OOEO70F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOD030E 
00000400 
09620000 
20000300 
E2400300 
08000300 
00000300 
00000962 
370C2000 



30301S3E 
D7:4Ci:9 
FFFFFFFF 
D20FB002 
4780909C 
333239C0 
913C50C0 
472090FE 
B33BB33B 
078A58B0 
001259B0 
50180036 
919C9130 
47809192 
D5E7FFFF 
30303030 
00000962 
0O00003E 
OOOOOOOE 
00300430 
09620000 
20000000 
E2400030 
08000 000 
00000030 
00000962 
070C2030 
0000E240 
8AF00800 
8AFO00OO 
20303000 
OO0EO70C 
04000000 
30308AF0 
FF008AF0 
070F2030 
OOOOOOOE 
00000400 
09620000 
OOOEFFOO 
300E070F 
04303300 
00000000 
00000962 



OO00B44E 
C4C9E3E6 
FFFFFFFF 
00380201 
95FFA000 
000358A3 
91C41BAA 
1BAB5AAB 
58C091C4 
OO8058B0 
91BC4743 
O201BO00 
B0024773 
47F090CA 
OOOE070C 
04000003 
00008AFO 
FF008AF0 
070F2000 
OOOOOOOE 
00000400 
09620000 
OOOEFFOO 
000E070F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 
09620000 
20000000 
E2400000 
08000000 
00000000 
00000962 
070C2000 
0000E240 
8AF00800 
8AF00003 
20000000 
000E070C 
04000000 
00008AF0 



00000C56 
FFFF0009 
FFFFFFFF 
BOOOOOBA 
4780910C 
00805 ACO 
BFA70041 
003C58B0 
58A0905C 
B01C350? 
915658B3 
91B050A0 
9110D702 
E2400000 
20000000 
E2400000 
08000000 
30003000 
00000962 
070C2000 
OO0OE24O 
8AF00800 
8AFO0OOO 
20000000 
000E370C 
04000000 
00008AF0 
FF008AF0 
070F2000 
OOOOOOOE 
00003400 
09620000 
OOOEFFOO 
OO0E07OF 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 
09620000 
20000000 
E2400000 
08000000 



OO009FO2 
FFFFFFFF 
FFFFFFFF 
50A0905: 
41AA0008 
A024581: 
47809110 
91B8BEA7 
49239036 
B00391C0 
91B450B0 
905C88A0 
BOOB BOOB 
00009654 
09620000 
OOOEFFOO 
OOOE070F 
04000000 
00300000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 
09620000 
20000000 
E2400000 
08000000 
00000000 
00000962 
070C2000 
0000 E240 
8AF00800 
8AF0OO00 
20000000 
000E070C 
04000000 
00008AFO 
FF008AFO 
070F2000 
OOOOOOOE 
00000400 
09620000 
OOOEFFOO 
00000000 
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The example below shows the beginning of a dump of the BG partition using 
the command DUMP BG when SYSLST is assigned to a line printer. 
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SYSTEM DUMP // OPTION DUMP statement 



If this statement is included in the job stream a dump of the partition, the supervisor 
and/or the SVA will be printed on SYSLST, whenever a program is canceled either 
by the operator or by other cancel conditions. The dump includes a printout of 
the supervisor area, and if the program check is within the SVA, a dump of the 
SVA or parts of it. For this reason the dump is often referred to as a SYSTEM 
DUMP. 

Note: There is no need to insert the // OPTION DUMP statement in a job stream 
if the default option of the DUMP parameter has been specified in the STDJC macro 
during system generation. If however the dump is not required when abnormal 
termination occurs during execution of a particular job, the // OPTION NODUMP 
statement must be included in the job stream. 

To enable the // OPTION DUMP statement to operate, one of two types of system 
dumps must be cataloged into your system during system generation: 

• A standard system dump, whose printed output is in hexadecimal code 

• A translating system dump, whose output is printed in hexadecimal and 
alphameric codes. 

The dump output includes the following: 

• General registers 

• Floating point registers, if FP is specified for the system 

• Control registers 

• Active communication region address (See Section 4 for a description) 

• Supervisor (see note below) 

• PD area, if PD is specified for the system (see B-3 in this section for details) 

• Label length 

• Partition identifier: BG, F4, F3 , F2, or F 1 

• Temporary real or virtual partition. 

• The Shared Virtual Area (See note 2 below). 

Note 1: The LTA (Logical Transient Area ) is used to contain the dump program. 
Therefore, the LTA printed in the dump will always contain the B-transients 
SSBDMPBC(ifthe dump is directed to a line printed or tape unit) or SSBDMPDC 
(if the dump is directed to a disk). 

Note 2: If a program check occurs in the SVA before the dump logical transients 
are loaded and have control, a dump of the SVA is executed. Even if the program 
check occurs in a phase within the SVA, the phase name of which has been deleted 
from the SDL (System directory list) before the dump transients have control, parts 
of the SVA are dumped that contain the phase in which the program check 
occurred. 

When to use 

Insert this statement into job streams for new, modified, or untested programs. 
The partition dump and general register dump can be analyzed and the 
information obtained will help during offline program debugging, 
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Dumps of, and changes to Real and Virtual Address Areas 

SYSTEM DUMP 



Begin the analysis by examining the error message issued on SYSLOG and/or on 
SYSLST. If the program check occured within the SVA, the message 

PART OF SVA WHICH CAUSES THE ERROR 

is printed after the dump of the partition in which the program is running, or if the 
entire program is running in the SVA, the message is printed after the dump of the 
program save area. A hexadecimal dump, including storage of the SVA, or a dump 
of the phase running in the SVA addresses in which the program check occurred — 
follows the message. 

The example below illustrates how to use the system dump in conjunction with 
program listings and the linkage editor map in order to isolate a data exception 
program check occurring in a program running in a BGV partition. 

Step 1 : Check for messages on SYSLOG and/or SYSLST. From the message obtain the address at which the 
interrupt occurred and reason for the program check. 





Step 2: Locate the register values printed at the beginning of the system dump. Scan the contents of register 
for unreasonable values. (This may help in later problem analysis.) 
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SYSTEM DUMP 

Step 3: Locate the linkage editor map and obtain the relocation factor. Subtract this value from the address 
given in the program check message. 

In case of a program check in the SVA, the relocation factor applicable is obtained as follows: 

1. Subtract the instruction address printed in the program check message from the first address 
printed in the dump of the SVA. 

2. Add the result to the start address printed in the assembly listing for the program or phase causing 
the error. 




Step 4: Locate the resulting address (from step 3) in the program listing. This will give the failing instruction. 




Step 5: Compare the hexadecimal code for the instruction in the program listing with the code in the dump. 
It should be the same. 



v 



|A-040i 



040640 . 

040660 47F0B2C2 47808302 95E0B985 4780B75C 

r.tijfiflfl <t°m-«c AFOCft.knt. 4 FA0r.60E 1A561A57 
406A0 001005EF 9507C83F i| T SOU *I"4_£850CDB2 

0406C0 58A0C0B2 D203C672 BBD2DE03 C67 

O406E0 CE105810 COAE58F1 001045EF O0OCD203 

040700 D203C682 BBD2D203 C686BB02 0203C68A 

040720 C67EC5FC DE03C682 C604DE03 C686C60C 

040740 CE29D202 B94DC677 020BB952 CDEED202 



10010 45EF00OC 
47F0B24C 4E50C566 4E60C5EE 4E70C5F6 
1A584E50 C6165810 CDAE4100 001B58F1 
5860C0B2 5870COB2 5880CDB2 583 
D283B936 B935D203 B951££«-B5T5B93B 
BBD2 P203C67A | ^fe t??D203 C67EBB02 
BB02 bE03 C676C5EC [ DE03C67A C5F40E03 
DE03C68A C6140283 B936B935 0212B93B 
B95DC67B 0210B962 CD9ED202 B972C67F 






■ fry ? / 



Step 6: Locate the location in the program listing that defines the data area used by the failing instruction. Use the 
relocation factor from the linkage editor map to calculate the address of the data area in the dump. 




Step 7: Locate the data^rea used by the instruction in the dump. Check if the data is specified for the failing 
instruction. If it is not, continue by identifying the point in the program listing at which the data 
is prepared. 



D£ c ^l 



041600 E2E5C340 05C5E640 50000048 92201004 
041620 00609240 1080DC07 10785000 F3841081 
041*40 ^477030 3C 90004000 90004000 47303048 
<t)41660) |000 00000 000004E91 00000000 0000004C 

mitm oooooooo ooooo«eSoooooooo 0000068C 

0416A0 F3841078 00? / / 

0416C0 40009DOO 40C *■ T 

0416E0 50000048 47FU3UII. E7O604EZ 4040F2F6 

041700 40202120 40202120 03D605C4 D6D54040 

041720 17800000 84000C00 00040004 17800004 

041 740 09041 7A4 6 0000020 090417C4 6000002F 



47F0301C 40404040 40404040 F3841078 SVC NEW G 0.. 3... 

00649240 10890C07 10815000 90004000 .- 6.3 £... . 

47F01010 40404040 40404040 40404040 0.. 

OOOOOOOO 0000010C OOOOOOOO 0000004C I.. 

OOOOOOOO 0000026C 8004033C 92601004 j/ /<— 

\S/'^ * ^**^ i*/"? "&**) !°::[°?°™ ^T^T^^^e. 

090417F3 6000001F 09041812 60000021 . . . .- 0- -.- £x H/t 
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DUMPGEN 



The IBM program DUMPGEN allows you to generate a stand-alone dump program 
that must be used to obtain information about the system under certain conditions 
of system malfunction. 

The dump consists of a printout of real storage (except bytes X'00'-XM7', X'40'— 
X'4B\ X'BA'— X'BB' and 214 bytes of a non-critical area in the supervisor). Two 
types of dump programs can be generated using DUMPGEN: 

• Translating dump 

• Formatting dump. 

Both programs produce a conventional dump with translation. In addition, the 
formatting dump produces a pre-formatted printout of the DOS/VS interface 
tables. This dump is generated if the DUMPGEN option FORM AT=YES is 
specified. 



DUMPGEN AND 

STAND-ALONE 

DUMP 



Executing DUMPGEN 

Before being able to execute DUMPGEN you must catalog it to the core image 
library. Execute it in any partition by the job control statement or command: 

// EXEC DUMPGEN 

You enter DUMPGEN and read its control statements from SYSIPT. 

Note that SDAIDS may not be initiated during execution of DUMPGEN. 
(SDAIDS are described in Section 2-B.) The two types of control statements used 
with DUMPGEN are ASSGN and OPTN, described as follows: 

ASSGN Statement: ASSGN defines the output device for the stand-alone 
dump program. 



-#£ f>. 



Name 


Operation 


Operand 


(blank) 


ASSGN 


SYSLST, X 'cuu' 



SYSLST The only valid logical unit assignment. 

X 'CUU' Must define the address of the SYSLST printer. If the ASSGN 
statement is omitted, then X'OOE' is assumed. 




'■'JOB-Dsrj 

I EXEC DoHf^'O 
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DUMPGEN AND 

STAND-ALONE 

DUMP 



OPTN statement: OPTN defines the type of output generated by the DUMPGEN 
program. 



Name 


Operation 


Operand 


(blank) 


OPTN 


INTR= NO 
YES 

DECKS= nnnnnn 
PPOOL= NO 
YES 

FORMAT= NO_ 
YES 

TAPEIPI_= NO_ 
YES 



Operands for the DUMPGEN option statement. 



INTR 



; ,o"\ £%$.(<■ 



DECKS 



PPOOL 



YES produces a DUMP program that, when loaded, enters the WAIT 
state. Either press the INTERRUPT button on the CPU operating 
panel to print the output on X'OOE', or press the STOP button and 
then START button of the printer desired for the output device. 
NO produces a DUMP program that, when loaded, prints out the 
contents of real storage either on the SYSLST printer defined with 
the ASSGN statement or on X'OOE'. 

Specifies the number of DUMP card decks (punched out on SYSPCH) 
desired, nnnnnn may be any decimal number from 1 to 99,999,999. 
A blank card separates each deck produced. If DECKS is omitted, one 
deck is produced. 

YES produces a dump program that, after printing out real storage, 
will print the formatted contents of the Boundary Box and the 
contents of the real storage in sequence of ascending virtual addresses. 
If NO is specified, the last two items are not printed. 



FORMAT YES produces a translating stand-alone dump that formats and displays 
the DOS/VS supervisor tables after displaying the contents of real 
storage. This formatted display depends upon the location of the 
communications region. 

If the communications region cannot be related, the program is 
terminated when the formatted display is to occur. 
In this case the following message is printed on the dump output: 

COULD NOT FIND COMREG BETWEEN CO AND A00, 
FORMATTING WILL NOT OCCUR 

If NO is specified or FORMAT is omitted, a non-formatting translating 
dump is generated. 

TAPEIPL If YES is specified and SYSPCH is assigned to a tape unit, the stand- 
alone dump written on tape may be IPLed directly from the tape unit. 
If NO is specified, or TAPEIPL is omitted and SYSPCH is assigned to 
a tape unit, the stand-alone dump records are written on tape preceded 
by an ASA control character. 
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Control statements for the DUMPGEN operands D UMPG E N AN D 

STAND-ALONE 

Control statements may be specified in any order; however, the following rules DUMP 

apply: 

• All statements may be omitted, but if they are, DUMPGEN assigns printer 
X'OOE', INTR=NO, FORMAT=NO, and PPOOL=NO options. 

• Only one operation and only one operand per control statement is allowed. 

• The last statement processed of a duplicate operation overrides all previous 
statements of the same operation with similar operands (if DECKS=2 is 
followed by DECKS=5, five decks are punched). 

• The name field must be blank. 

• Decimal operands may contain leading zeros. 

• One of more blanks must follow the operand if comments are to be made. 

Job stream example 

The following example is a typical job used to create a stand-alone dump. 

// JOB 

// EXEC DUMPGEN 

Col. 2 

ASSGN SYSLST, X'OOF' 
OPTN FORMAT=YES 
OPTN PPOOL=YES 
OPTN DECKS=5 

/* 
/& 

DUMPGEN messages 

The functions of DUMPGEN-to-operator error message routines are: 

• Cancel the job if SYSLOG is not a 3215/3210 or a System/370 Model 125/1 15 
video display unit. 

• Reissue the message if operator response is to press the CANCEL key 

• Process an operator response of END/ENTER as IGNORE 

• Cancel the job if operator response is CANCEL. 

• Ignore the control card in question when the operator response is IGNORE. 

If none of the preceding operator responses is issued, then DUMPGEN assumes 
that a correction has been made and processes it. 
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DUMPGEN AND Stand-alone Dump Program 

STAND-ALONE 

DUMP This program is generated for your installation using the IBM program DUMPGEN. 

DUMPGEN produces a dump program that is either punched into a card deck or 
stored on magnetic tape. When required, the dump program thus generated can be 
loaded into the system via the standard IPL procedure. 

The stand-alone dump program that is generated by DUMPGEN provides either 
a conventional dump or a formatted dump, depending on the FORMAT option 
used in the DUMPGEN program. 

Operation 

During execution of the stand-alone dump program, a non-critical area in the 
supervisor is used to load the program. The LOAD ADDRESS of the non-critical 
area is punched (in decimal) in the first card of the stand-alone dump card deck 
punched by the DUMPGEN program. Because of this use of the non-critical 
area it is recommended to use the stand-alone program for a system using a 
supervisor that was used for the generation of that dump. 

The conventional dump prints the contents of real storage locations, but does not 
dump the floating point registers. In addition to the areas dumped by the conven- 
tional dump, the formatted dump prints the DOS/VS interface tables in a more 
readable form. 

For both types of dump the following is printed: 

1 . The contents of the general registers, the old and new PSWs, the interruption 
codes, CSW, CAW, and TIMER. 

2. The contents of real storage in 2k blocks. Each block is preceded by a 
sequence number. 

3. At the end of the real storage dump, page address and status information is 
printed that contains the following information for each page frame: 

• The virtual address 

• The real address of the associated page 

• The sequence number of the 2k block 

• Information that indicates whether the contents of the page frames 
has been changed. 

4. The contents of the control registers are printed after page address and 
status information. 

5. Depending on the options selected, the following then occurs: 

IfPPOOL=YES 

• The formatted contents of the boundary box is printed after the 
control registers. 

• The contents of real storage is printed in 2k blocks in sequence of 
ascending virtual addresses. 
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If FORMAT=YES, DjJMPGEN AND 

the formatted contents of the tables listed below are printed at the end STAND-ALONE 

of the dump. DUMP 

COMREGS 

PIBs 

AP SUBTASK PIBs (if AP supported) 

PARTITION SAVE AREAS 

LUBs 

PCI L LUBs (if PCI L supported) 

PUB 

ERROR RECOVERY BLOCK 

CHANNEL QUEUE 

FLOATING POINT REGISTERS 

COPIED AND TRANSLATED CCB 

FIXINF EXT. BLOCKS 

COPIED AND TRANSLATED CHANNEL PROGRAM 

IDAL BLOCK QUEUE 

FIXINF BLOCK 

BOUNDARY BOX 

SEGMENT TABLE 

PAGE TABLE 

PAGE FRAME TABLE and PAGE FRAME TABLE EXT 

SELECTION POOL 

The full names of these tables, their contents, locations, and meaning to 
the system programmer during offline program debugging are found in 
Section 4. 

An example of the formatted output of these tables is given in Appendix G. 

The two following illustrations show the information that is printed 
after executing the dump program. 

When to use 

The stand-alone dump program must be used whenever the severity of a 
system malfunction, such as a loop or hard wait state, prevents alternative 
methods of obtaining system information that aids offline debugging. 

Flowcharts in Section 3 indicate when to execute the stand-alone dump 
program. 
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STAND-ALONE 
DUMP 




1 6 General Registers 

Low address storage 
(Formatted). 



Last 2k block of 

real storage. (Without translation.) 



First 2k block of real storage 
beginning at byte 0. (With translation). 



2k blocks of real storage, (With translation). 



Last but one 2k block of real 
storage, (With translation). 



Page address and status information 
16 Control Registers. 

The contents of tables and areas 

as listed in the previous text are printed 

(See appendix G for an 

example of formatted output of these areas). 



PSWS 
EXT OLD 
EXT NEW 
EXT INT 
SVC OLD 
SVC NEW 
SVC INT 
PGM OLD 
PGM NEW 
PGM INT 
MCK OLD 
MCK NEW 
MCK INT 
I/O OLD 
I/O NEW 
I/O INT 
CSW 
CAW 
TIMER 



V FORMAT=YES 



A pictorial representation of the stand-alone dump and formatted 
printout, generated using DUMPGEN options FORMAT=YES 
and PPOOL=NO. 
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PSM/S 
e XTOLD 
1 E *TMEW 
E *T | Mr 
; SVC OLD 

- svc mew 

SVC INT 
PGM OLD 
pQ M NEW 
PQ M INT 
MCK OLD 
MCK MEW 
I 'WCK/MT 
f '/OOLD 
'/O MEW 
'/O IMT 
CSW 
CAW 
TIMER 
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DUMPGENAND A note to the operators 

STAND-ALONE 

DUMP Before the stand-alone dump program is executed, the operator must dump, or 

display and note, the contents of bytes X'OO' through X'17', X'40' through X'4B\ 
X'BA', and X'BB' of low address storage. (The contents of these bytes will be 
destroyed when the dump program is loaded.) It may be important to the pro- 
grammer to have a note of the contents of the control registers at the time of the 
error. This can be done by (1) executing the store status function or (2) dumping 
or displaying the control registers using the ALTER/DISPLAY feature described 
in Section 2-D. The operator should also display and note the current PSW before 
executing the dump. Also there may be a need to dump the page data set after 
executing the stand-alone dump. For example, the programmer may have made a 
request for a "SYSVIS dump" after the execution of a stand-alone dump. The 
flowchart shown opposite indicates the procedure for loading and executing the 
stand-alone program. 

A note to the programmers 

To ease the task of locating and interpreting the contents of control blocks and 
tables during offline debugging, generate the formatted dump program 
(FORMAT=YES). 

A note to IBM SE /CE 

For any System/370 supporting RAS the serial number and System/370 Model 
type is stored in the first 8 bytes of the RAS linkage area, the address of which 
is located at displacement X'70' of SYSCOM. 

How to use 

Initially the following listed areas should be examined, for what appears to be 
unexpected information. 



1 . General registers. "I 

2. Current PSW and old PSWs. J See note ' 



3. From the PIB table locate the partition 'in control at the time of the error. 

4. Registers and the PSW in the partition save area. 

5. Using the program listing of the program that was running in the failing 
partition, scan the I/O areas, instructions, intermediate results, and 
operands in areas you consider critical to the program. 

6. Use the linkage editor map to locate where the system should load the 
phases. 

7. For further analysis, check the PUB table for any I/O request left out- 
standing, and, depending on the type of the program in error, check the 
CCB/DTF table and label save areas. 

The order in which these areas are examined rests with you, who as programmer, 
will know what the program was expected to do, and approximately what the 
contents of certain registers and I/O areas should contain. 

An example of a stand-alone output is given in appendix G. 

By examining the dump in this way and by consulting the program listing you 
will be able to form an idea of the cause of the error, and to discover where to 
look for further clues or pointers. 

However, the first pointer will depend on the symptoms of the error, the 
environment, what the program was expected to do, any output that became 
available, and incorrect results of calculations. 

Note: Use the information printed at the start of the dump, that is before the print 
out of the last block of real storage. (The contents of low address storage is not 
reliable after the execution of a stand-alone dump program.) 
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STAND-ALONE 

DUMP 



Start 



Before executing, dump, 
or display and note the 

• Current PSW 

• 1 6 control registers 

• 16 general registers 

• Low address storage 
X'OO'-X'BF' 




Mount tape on a tape 
unit ensuring that the 
number of tracks and 
density is identical to 
that used when the 
tape was produced 



Set address switches or 
set address in display of 
the tape unit 



} See D-1 -F for Models 1 35, 1 45, 1 55-1 1 
land D-2-F for Models 1 15, 125 
land D-3-F for Model 1 58 



A-3-F 



YES 



Dump program 
on card deck 



Place card deck in a 
card reader 



Set address switches or 
set address in display of 
the card reader to be 
used 



To next page 
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A wait state occurs if 

INTR YES is specified 

during generation of the 

dump program using DUMPGEN. 



The contents of REAL storage is 
printed in blocks of 2K bytes on 
the line printer specified in the 
ASSGN statement of DUMPGEN 
or the line printer made ready 
after entering the WAIT STATE. 
Other information is also printed 
depending on the type of dump 
program generated by DUMPGEN. 



r 



y 



The SYSVIS dump utility program 
is described under C-6 in this Section 




From previous page 



Press the STOP key, 
the SYSTEM RESET 
key, and the LOAD 
key, in that order 




YES 



Press the INTERRUPT 
key, or the START 
button on the printer 
desired as output device 



The DUMP is 
executed 



The following procedure executes the SYSVIS dump utility program. This 
procedure copies the PDS to tape or disk which can then be dumped to SYSLIST 
if required during offline debugging. It is also possible to dump the PDS directly 
to SYSLST. To ensure that the contents of the PDS and the allocations of the 
virtual address area are the same as they were just prior to the execution of the 
stand-alone dump the following instructions must be adhered to: 

1 . Re-IPL using identical parameters for the DPD command as specified in the 
previous system IPL. However you must specify N to the parameter TYPE=. 

2. Check for any previous ALLOC commands. You must specify identical virtual 
partition allocations as existed just before the stand-alone dump was executed. 



Example 1 

//JOB DUMPPDS 

// ASSGN SYS000,X'cuu' 

// ASSGN SYS001,X'cuu' 

// DLBL PDSDISK/PAGE DATA SET' 

// EXTENT SYSOOO 

// DLBL S01DISK/BACKUP FOR PDS', 

// EXTENT SYS001J 1111 1 ,1 ,,0020,180 

// EXEC PDSDM 

/& 



Example 2 

// JOB DUMPPDS 

// ASSGN SYS000,X'cuu' 

// ASSGN SYS001,X'cuu' 

// DLBL PDSDISK/PAGE DATA SET' 

// EXTENT SYSOOO 

// TLBL S01TAPE/BACKUP FOR PDS' 

// EXEC PDSDM 

/& 




YES 



Use the SYSVIS dump to 
copy the PDS to disk. 
See JCS example 1 



Use the SYSVIS dump to 
copy the PDS to tape. 
See JCS example 2 



Wait for message 0V20D 
on SYSLOG then press END 



Save the copied PDS for your 
system programmer and /or 
IBM CE/SE. He may need 
it to complete offline 
program debuggi ng. 



Continue normal processing 
with the next job 



2.24 Serviceability Aids. 



Dumps of, and changes to Real and Virtual Address Areas 

PDAIDS TRANSIENT DUMP 

PDAIDS (problem determination aids), are routines especially designed to 
provide specific information useful during offline debugging. These routines 
consist of four trace routines, which are described in Section 2-B of this manual, 
and one routine called the transient dump program. 

Transient Dump 

This program is designed to dump, on a program check, areas of the supervisor 
before they are altered. The dump provides: 

• the 1 6 general registers 

• the 1 6 control registers 

• the first X'20F' bytes of low address storage 

• the logical transient area (with the label LTA) 

• fhe physical transient area (with the label PTA). 

This information may be provided on either a printer or a tape unit. When tape 
is used, the tape must be processed by the PDLIST utility program to provide 
readable output data. PDLIST is described in Section 2-B. Both the printer and 
tape modules are reusable, that is a dump occurs with each program check until 
the function is reset. 

The printed dump outpiit is non-translating. 



System requirements 

Because the Transient Dump program is a PDAID function, it requires the 
PDAID initializing phase and a PD area. Refer to "System Requirements" 
for Trace Routines in Section 2-B-l. 
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Dumps of, and changes to Real and Virtual Address Areas 

TRANSIENT DUMP Initializing the transien t dump 



Initializing is done by calling the PDAID program via the job control statement 
// EXEC PDAID. 

The parameters for the dump may be entered through SYSLOG or through the 
card reader assigned to SYSIPT. 

Note: No other PDAID can be executed when the transient dump program is 
initiated. 



If SYSIPT is to be used, the card deck must be punched as follows. 

Punch desired keywords and parameters, as shown in example 1 , into cards. 
Entries may be punched one-per-card, or as multiple entries (separated by commas) 
in a single card. An entry may not be split between two cards. All 80 columns of 
a card may be used, but a card is terminated either by the first blank following an 
entry, or by a GO entry. The last entry of the last card must be GO and the last 
card must be followed by a /* card. 

Note: If an incorrect parameter is read from a card, corrections are requested 
on SYSLOG. 

When the main phase (PDAID) has been loaded into any free partition (one must 
be made available), the following message is issued on SYSLOG: 

4C10DPDAID= 

The operator must respond to this message with one of the following: 

• TD Initiates transient dump. 

• XX Terminates PDAID. 

• END key Indicates that the parameters are to be entered via SYSIPT. 



2.26 Serviceability Aids. 



Dumps of, and changes to Real and Virtual Address Areas 

Selecting the Output Device TRANSIENTDUMP 

The initializer keyword OUTPUT DEVICE selects an output device, which must: 
be specified by channel and unit address, not by symbolic unit. When an output 
device is specified, the initializer checks the address against the supervisor PUB 
and automatically selects the appropriate module for the unit type (tape or 
printer). 

Once the transient dump program has been initiated, it is given control each time 
a program check interrupt occurs. When it has control, the transient dump 
program has highest priority, and the system accepts only external interrupts. 
All system processing is suspended and the operator must ready the transient 
dump output device. 

When to use 

Use the Transient dump when you suspect coding errors in the transient routines, 
for example, your own error recovery routines for devices not supported by IBM. 
The information obtained from the dumps will help during offline program 
debugging. 

Terminating the transient dump 

The transient dump program can be terminated by re -initializing the PDAID 
program (// EXEC PDAID), and responding to the message PDAID= with XX. 
It is also possible to reset (terminate) the transient dump by loading one of the 
PDAID trace routines. 

The following illustration represents the action of the transient dump program if 
a program check interrupt occurs in the LTA. 
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Dumps of, and changes to Real and Virtual Address Areas 

TRANSIENT DUMP 



16 general registers 
16 control registers 



Line printer 

or 

magnetic tape 



527 bytes decimal of 
low address storage 



*-i 



Supervisor transient areas 
(Refer to Section 4 for details) 



Pictorial representation of the information that is dumped. 



U 



Real Storage 



Low Address Storage 



Model dependent 
log out area 



Supervisor Transient 

Area 

(LTAandPTA) 



Background 
Partition 



'N 



> 



SUPERVISOR 
AREA 
(Refer to 
Section 4) 



J 



Keyword 


Parameter 


Meaning 


Default 


PDAID 


TD 
XX 


Initiate transient dump. 
Terminate function 


Function 
continues. 


OUTPUT 
DEVICE 
(Note 2) 


CUU or X'cuu' 


Use specified output device for output of 
transient dump function. 




GO 
(Note 1 ) 




End of initializer keyword entries. 





Note 1: GO is an invalid response to a request for a console correction to card input. 

Note 2: A printer or tape output device must be specified for transient dump. 

CUU or X'CUU' notation must be specified by channel and unit address, 
and not by symbolic unit. 

Two examples of initiating the transient dump immediately follow the flowchart shown opposite. 
Table A-4. Table of parameters for initializing the Transient Dump 

2.28 Serviceability Aids. 



Dumps of, and changes to Real and Virtual Address Areas 

TRANSIENT DUMP 
Initializing the Transient Dump 



//JOBDUMPTA 
//EXECPDAID 



4C10DPDAID 



Enter XX 
and press 
END 



Enter TD 
and press 
END 



Press 
END 



4C1 1 D OUTPUT DEVICE = 



Terminate 
Transient Dump 



Select output 
device 



Transient Dump 
is initiated 



Print the Transient 
Area 



Read Parameters 
fromSYSIPT 



A-4-F 




//EXECPDAID 

PDAID=XX 

/• 

// ASSGN SYS005,X'cuu' 

// MTC REW,SYS005 

// EXEC PDLIST 

/* 

/& 



The LTAand PTAwillbe 
dumped on the selected output 
device if a program check interrupt 
occurs in the transient area 



Print dump using 
PDLIST utility 
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Dumps of, and changes to Real and Virtual Address Areas 



TRANSIENT DUMP 



Job stream examples 

The following two examples show job stream to initiate the transient dump 
program. 

Example 1 , via SYSIPT: 



//JOBCARDINP7 

//EXECPDAID 

PDAID=TD 

OUTPUT DEVICE=00E 

GO 

'/* 

/& 



Calls for initializer. 
Calls for transient dump function. 
Specifies printer output. 
Signals end of input. 



Note: A dump is given on all program checks. 



Example 2, via SYSLOG: 

//JOBTYPINPT6 

//EXECPDAID 

PDAID= 

TD and END key 

OUTPUT DEVICE= 

00E and END key 



Calls for initializer. 

Console requests function. 

Operator specifies transient dump function. 

Console requests output device. 

Operator specified printer output. 



Note: An output device must be specified for the transient dump function. 
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Dumps of, and changes to Real and Virtual Address Areas 

TRANSIENT DUMP 





KENSDUMP 




12/06/73 












/^//> 


/XMM&tf //&»i/( 




GR 0-F 


00040684 


00008620 


00040298 


00040308 


000085B1 


08040300 


00000000 


0000840A 














000084BC 


00000008 


00040280 


00040688 


00040078 


00000008 


80008300 


000082E8 












CR 0-F 


004000FF 


0000E640 


FFFFFFFF 


FFFFFFFF 


00000000 


00000000 


00000000 


00000000 




00002876 


Xhcj ~J/ /?SU/ 




000000 


OOOOFFFF 
00000000 


00000000 
00000000 


00000000 
00000000 


00000000 
00000000 


00000000 
00000000 


00000000 
000004A0 


C2000000 
07100000 


00000200 
0004044A 


040COOOO 




^-— —v 




[07000000 


000082F6IJU 




_ 000030 


00000000 


00000000 


070F2000 


0000090C 


OOOO87A0 


OCOOOOOO 


00003AB8 


00000000 


FE3BD600 


055C0E26 


040C0000 


oooOTewr"\ 




• 000060 


040COOOO 


00000BCC 


OOOCOOOO 


OO0OA5OC 


04080000 


0000013A 


040C0000 


00000810 


00000540 


00000080 


00020007 


00060001 \ 




000090 


12042003 


00020000 


00000000 


000001CC 


00000000 


00000000 


20000060 


O0OO02C0 


00000000 


00000100 


00000130 


00000000 \ 




ooooco 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 \ 




• OOOPFO 










00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 1 




000120 










30000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 ) 




_ 000150 


f~69&4~ ^^ ■f"' 


e/ ' /.T/ 1 


30000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 / 




• 000180 




<s &*ruc& 






30000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 / 




0001 BO/ 


QjOi>& > 


Ja^Jtlt «fj»^ud Ol^ 


/iZfHjU,,/ D000O00O 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 / 




- oooiEor 






*7C*xpiK(WIC 


30000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


oooooooo y 




LTA 51 
. 0082E8 
• 008318> 


■r ■!>■■/- 




/c; ji^. 


30044710 F09495FE 
4710F080 9108A087 


70004780 
4710F076 


= 2ZFt 

F0389551 
9110A087 






J^s 




0WOOE 
91013002 


28004590 
4710F08A 


— /'ttc*6* 
F2669101* 
91023002 


80044780 
47E0F05E 


F038D300 
94EFA087 


F4188004 
0A0B9550 




5B5BC206 


D7C5D540 




'9550F418 


4780F0B6 




S~ 008348 


F4184770 


F0705860 


20080201 


40266006 


4110F41A 


OA024110 


F42A94F7 


AO87OA02 


4110F43A 


94F03002 


0A024110 


F43294FE 




_ / 008378 


30020A02 


4110F422 


0A020A00 


91801002 


4710F0A6 


0A079120 


10024710 


FOB007F9 


92FFF419 


07F94160 


F3F04060 


100A4590 




$80PW 008308 
£[ 008408 


F09A9108 


F 20747 10 


F0DCD6O5 


40204020 


4780F038 


96044003 


47F0F038 


9104 A087 


47E0F0EC 


94FBA087 


47F0F104 


4160F3F8 




4060100A 


4590F09A 


4160F400 


4060 100 A 


4590F09A 


95FFF419 


4780 F038 


9118A087 


4770FUC 


91112014 


4710F126 


D503F2EE 




F40E4780 


F12CD205 


F2F2F412 


D5054020 


F4084780 


F2340505 


4020F2F2 


4770F15A 


D505F2F2 


F4 124770 


F2349110 


30024710 




• 008438 


F15A9112 


2O1447E0 


F234076B 


F26AF26A 


9280F2S8 


9203F282 


O201F286 


8004920A 


F28A02O1 


F2848O00 


9206F291 


D205F2B4 




008468 


F2069201 


F2899550 


80044780 


F1B89218 


F2919214 


F28AD217 


F2BEF206 


9204F289 


926CF30C 


95538004 


4770F1B8 


9209F291 




008498 


920SF289 


9250F30C 


D205F292 


40200200 


F2A58005 


D201F29E 


400B0201 


F2A24012 


0201F2A0 


4001D200 


F2A44000 


0203F2A6 




• 0084C8 


400E0201 


F2984026 


95508004 


4770F214 


D209F2AA 


40300602 


40004000 


4780F234 


07024000 


40000733 


40084008 


9250F3DC 




0084F8 


47F0F230 


D213F2AA 


403OD602 


40004000 


4780F234 


07024000 


40000738 


40084008 


4590F24A 


9110A087 


4710F240 


96044003 




m 008528 


02054020 


F2F247F0 


F0380203 


F266F30C 


18514110 


F2660A2C 


9180F268 


4710F262 


0A071815 


07F958A0 


001458BO 


A0885830 




• 008558 


B01C4110 


F3E09118 


A08747B0 


F2A24000 


10064590 


F3821821 


45E0F394 


1B444347 


00008940 


00014844 


30345A40 


303047F0 




008588 


F0B69180 


A0594710 


F0701820 


91033002 


4740F34E 


9104 A058 


4710F32E 


91013004 


4710F320 


1BDO18C0 


412C0000 


95002000 




— 008588 


4770F320 


58220000 


95FF2007 


4780F2F0 


95202014 


4740F2F6 


95282014 


4720F2F6 


96013004 


07F99532 


20144770 


F31845E0 




• 0085E8 


F39495FE 


70004780 


F3180300 


F4188004 


9560F418 


4780F2FO 


41000004 


47F0F2C8 


94FE3004 


18205822 


000047F0 


F34E5820 




008618 


F4AC9500 


20044780 


F34A9102 


A05847E0 


F0705822 


000047FO 


F34E5822 


000495FF 


20074780 


F0709520 


20144740 


F3669528 




_ 008648 


20144700 


F0700201 


10062006 


45E0F394 


1B664360 


70008960 


00014846 


30345A40 


30304160 


F 2064060 


F3F24160 


F2EE4060 




• 008678 


F3FA07F9 


487A007C 


488A002E 


48887002 


487A004A 


D200F3BB 


70001B77 


43720007 


91012006 


47E0F3BC 


41770000 


1A781A77 




0086A8 


4A7A004C 


1B884387 


00008980 


00034A8A 


00400 7FE 


00000000 


00000000 


00300400 


00001500 


00000000 


00000000 


20000000 




_ 0086D8 


O40002D6 


20000018 


020002EE 


2000000C 


07000400 


20000001 


00000000 


0O0OE506 


03F 14040 


40404040 


00005B58 


C20607C5 




• 008708 


05F15B5B 


C2D607C5 


D5C45B5B 


C2D1C306 


07E35B5B 


C20604E3 


F0F15B58 


C20604E3 


F0F5OOOO 


00000000 


00005COO 


012C0000 




008738 


84000000 


92600004 


00006060 


C2C76060 


C3D6D409 


C5C74040 


C2C740C1 


C4C40940 


C9E240F0 


F0F0F4C1 


F003C2D3 


E3E80740 




« 008768 


40C8C5E7 


4003C5D5 


C7E3C840 


C9E240F0 


F OF OF 060 


074BC44B 


604040C1 


09C5C100 


000020F2 


F14BF1F3 


4BF1F660 


80041224 








/v^ 


^^^6 


z- */ f& 


lo&itca. 


■cn^oeoxan 


- X'c 


7' 


///on 

^ a. 




&&rtp\ 












' / 








& -non - &x>ct^e^c 


0/° *C<r<f4L 




m PTA 
















(tfa 


^CatttJZ $f / 


i?*r&fae- 


m ^C^ec&j 




• 008E60 


5B5BC1C2 


C509E9F1 


28005890 


00144890 


90845 SCO 


008048AO 


905A9287 


A0009102 


903547E0 


B02E48A0 


C05847F0 


B03248A0 




008E90 


906E4AA0 


905A1B88 


BF87A005 


5810802C 


45708068 


48F0C046 


58E0C004 


9280AOOO 


9127AO08 


4780B05C 


9283A000 


5860CO0O 




_ 008EC0 


D2016006 


B0C407FE 


95FF1002 


4780B09A 


1B554350 


10028950 


00035A50 


C0249500 


50044780 


B0B895FF 


50004780 


B09A1B44 




• 008EF0 


43405000 


185447F0 


B0764111 


000895FF 


10004770 


B0689283 


A0009680 


A00146A0 


905A94DF 


A00807F7 


5010802C 


OA0348AO 




008F20 


905A07F7 


D9C1D201 


OOBA3000 


4A20905A 


18A248FO 


CO0847F0 


B23C4100 


B29094A0 


00084570 


B14A0508 


B02AB342 


4780B21A 




_ 008F50 


0505B02A 


B3364770 


B14A18A0 


4850C02C 


4860907C 


41AA0010 


41660010 


0501B031 


B3424780 


B1200501 


B031A002 


4770B142 




• ',' 008F80 


9180600F 


4780B1A8 


4140B21A 


4100B2D8 


9226B267 


9220B264 


4570B14A 


9260B264 


07F44650 


B10492F2 


B2ABBE07 


82614100 




008FB0 


B260BE07 


B31F4100 


B02ABE07 


B2710708 


B02AB02A 


4100B34C 


8E07B269 


4110B316 


0A0F9180 


10024710 


B17C0A07 


9120B318 




_ 008FE0 


4710B21A 


9218B267 


9101B31A 


4780B19C 


4100B270 


BE07B31F 


47F0B15E 


0608B02A 


B 3424100 


B2A807F7 


4100B2C0 


91029035 




• 009010 


47E0B1E6 


4120000F 


4B20C02C 


4830C02C 


89300004 


4A30905A 


41330010 


05013002 


A0024770 


B1E29601 


3000960C 


300F9210 




009040 


30014620 


B1C89580 


A0004780 


B14A9110 


A00F4770 


B14A9601 


A00048F0 


C00A47F0 


B23C4100 


B2FE9218 


B2679220 


B2644570 




_ 009070 


B14A9260 


B26447F0 


B03E48F0 


C04658E0 


C0049280 


00009127 


D0084780 


B2329283 


00005860 


C00092C1 


600707FE 


91400008 




• 0090A0 


47108248 


94F8D008 


4BA0905A 


42A0902F 


91029035 


4760B21E 


42A0CO5B 


47F0B21E 


090090F0 


60000018 


010091AC 


60000004 




009000 


0A0O8E8A 


20000009 


FOD7F6F0 


C440C9D5 


E3C509E5 


4009C5D8 


40404040 


40FOFOFO 


F1C9F4F0 


C44009C5 


08E4C5E2 


E340C3C1 




_ 009100 


05C3C503 


40404040 


F1E2F0F1 


C440C905 


E5C103C9 


C440E2E3 


C1E3C504 


C5D5E340 


F1C9F3F2 


C440C109 


C5C140D5 


06E340C1 




• 009130 


C3E3C9E5 


C5404040 


F108F6F2 


C940C3C1 


D5C3C5D3 


40C60609 


40D706E6 


C5D940D7 


0906C7D9 


C10440C9 


C7D506D9 


C5C4F007 




009160 


F8F9C940 


C9610640 


C3C1D5C3 


C5D340C9 


C7D506D9 


C5C40003 


81000800 


00040000 


90C0OO00 


9008F0F1 


F2F3F4F5 


F6F7F8F9 




— 009190 


C1C2C3C4 


C5C6C3C1 


D5C3C503 


C9C 70506 


D9C54040 


40404040 


40404000 


CI 094040 


00000000 


00000000 


00000000 


oooooooo 




• 0091C0 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


OOOOOOOO 




009 IF 


00000000 


00000000 


00000000 


00000000 


00000000 


00004040 


40404040 


40C3C3E2 


E67EF0F1 


F1F0F0F4 


F0F4F2F0 


F0F2F0FO 




_ 009220 


FOFOFOFO 


40C3C3C2 


7EF0F4F0 


F4FOF040 


E2027EF6 


FIF6F1F0 


FOFOFOFO 


F0F0F000 


F007FOF8 


C1404040 


40C9D5E3 


C509E540 , 




• 009250 


D9C5D840 


E2E8E2D3 


E2E37EF0 


F0C56000 
















/Z/W& 




Transient Dump output 

This example shows the output obtained from the transient dump program. (The dump is 
output when a program check occurs in the transient area.) 

The programmer's remarks on this example indicate the main points of interest to aid offline 
debugging, however this depends on the error symptoms and system environment. 
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COMMUNICATION 

MACROS 



Dumps of, and changes to Real and Virtual Address Areas 

PDUMP (partial dump) macro 

This macro instruction provides a hexadecimal dump of: 

• The general purpose registers 

• The floating point registers (if FP is supported) 

• The control registers 

• The virtual storage area contained between two address expressions. 

The addresses can be expressed in decimal or hexadecimal or in register notation 
and need not be confined to any one partition. 



Name 


Operation 


Operand 




(name) 


PDUMP 


address 1 , 


address 2 






(r) 


(r) 



Address 1 specifies the start address of the 
storage to be dumped. 

Address 2 specifies the end address of the storage 
to be dumped. 

(r) one or both of the addresses can be 

specified in any of the general registers. 

The contents of registers 0-1 are destroyed, but the CPU status is retained. Thus, 
PDUMP furnishes a dynamic dump (snapshot) that is useful for program checkout. 
Processing continues with the next user instruction. 

The dump is always provided by SYSLST on 121 -byte records. The first byte 
is an ASA control character. If SYSLST is a disk drive, the user must issue an 
OPEN macro to any DTF assigned to SYSLST after each PDUMP that is 
executed. The OPEN macro updates the disk address maintained in the DTF table 
to agree with the address where the PDUMP output ends. If OPEN is not issued, 
the address is not updated, and the program is canceled when the next PUT is 
issued. 

The specified addresses are checked against the end address of virtual storage. If 
address 1 is higher than the end address of virtual storage, or if address 1 is higher 
than address 2, the PDUMP macro results in no operation. If address 2 is higher than 
the end address of virtual storage, address 2 is automatically set to that address. 

If address 1 and 2 are identical, only the contents of the general registers, the 
control registers and floating point registers are dumped. (Floating point registers 
are dumped only when the supervisor supports the floating point option.) The 
dump output can be either standard (non-translating) or translating, depending on 
the dump program cataloged in your system transient library. 

Note: Addresses for this macro may not be specified by register notation for 
programs eligible to run in the SVA (shared virtual area). 
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Dumps of, and changes to Real and Virtual Address Areas 



When and how to use 



PDUMP is useful when you need to know the contents of specific virtual storage 
areas at specified points in the program during program execution. For example, 
you may want to examine the contents of storage areas that are being modified 
during program execution, such as I/O areas. 

The following example illustrates the use of the PDUMP macro. 



SUPERVISOR 

COMMUNICATION 

MACROS 























400 


OUT CANCEL 








• 




405 


««*«*««»«**««»»»**»»»#»**«**♦»«*»«*»»«*»****»***»****»*»**»****«**«»«*» 










406 


•LOOP TIMER ROUTINE* 












407 


»*»»»«»♦*»»»»»*«»««»»»«**»***»**»*»»«»**««*««*•»»»»**»»****»»»»»»**»»** 








• 


003C7E D24F C2BF C2BE 04AC1 04AC0 


408 


TIHINTR NVC BUGSWARNtBUGSHARN-1 








003C84 D22T C2BF CD4F 04AC1 05551 


409 


HVC BUGSMARN(40)fCHKPTMRN 












410 


PUT TVP0UT1 








• 




415 


PDUMP L00PCNTtL0OPCNT+3 DUMP LOCATIONS USED AS COUNTER 










420 


* FOR THE LOOP AT EACH TIMER INT. 












421 


EXIT IT 








• 




424 


»»***»**********************»*»**»**»**»***«*«»***»***»*****»**»***»*»* 










425 


•END OF LOOP ROUTINE* 


(/Tx/3 / 0£hJ l 










426 


•**•****••**•**••***•********•*****•*•••****•**•**•****•*******••*****• 



















This source code listing shows the PDUMP macro where the programmer needed 
to know the contents of an area used as a counter. 



The following dump printout was obtained when the program was executed. 










• 




KENT0MS1 12/06/73 




PAGE 


1 






• 

• 


GR 0-7 
GR 8-F 
FP REG 
CR 0-7 
CR 8-F 

041680 


00041E10 00041E08 00000049 00000000 
00000001 00O0CA34 00000013 4004007A 
00000000 00000000 00000000 00000000 
004000FF OOOOE640 FFFFFFFF FFFFFFFF 
0000FFFF 00000000 00000000 00000000 


00000000 00000050 00000010 00000002 
0004107A 07C8C1E2 800A050E 000422F8 
00000000 00000000 00000000 00000000 
00000000 00000000 00000000 00000000 
0000.000 00000000 C2000000 00000200 

0000CA34 




"^£^2 





















Restriction: 

The message INVALID ADDRESS SPACE is printed on the dump output if the 
dump includes storage areas considered to be invalid address space. 

The definition of invalid address space is listed under "Restrictions" in the 
description of the ALTER command. 
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Dumps of, and changes to Real and Virtual Address Areas 

DUMP macro 



SUPERVISOR 

COMMUNICATION 

MACROS 



This macro, when assembled into your program and executed, will dump the 
following system information: 

• The general registers 

• The floating point registers (if FP is supported) 

• The control registers 

• The active communication region address (see Section 4 for a description) 

• The supervisor 

• The PD area (if PD is specified for the system; see B-3 in this Section) 

• The label length 

• The partition identifier BG, F4, F3, F2, or Fl 

• The temporary real or virtual partition issuing the macro. 



Name 
(name) 


Operation 
DUMP 


Operand 



If the program or main task issued the macro, the job step is terminated 



JDUMP macro 



Name 
(name) 


Operation 
JDUMP 


Operand 



If the program of main task issued the macro, the main task (the whole job) is 
terminated and a dump is made of those areas listed in the description of the 
DUMP macro. 



2.34 Serviceability Aids. 



Dumps of, and changes to Real and Virtual Address Areas 



The following considerations apply to both the DUMP and JDUMP macros: 

1. If a subtask issues these macros, the subtask is detached, the job step or job, 
respectively, is not terminated, and the dump described above is executed. 

2. The dump is always provided on SYSLST, which, if disk or tape, must be 
OPENED. 

3. If either macro is issued by a program running in real mode, the temporary 
real partition is dumped. However, if these macros are issued by a program 
running in virtual mode, the whole virtual partition is dumped. 

4. The dump output can be either standard or translated, depending on the type 
of dump cataloged into your system during system generation. 

5. The LTA (Logical Transient Area) is used to contain the dump program; 
therefore, the LTA printed in the dump will always contain a B-transient 
$$BDUMPB (if the dump is directed to a line printer or tape unit), or 
$$BDMPDC (if the dump is directed to a disk drive). 



SUPERVISOR 

COMMUNICATION 

MACROS 



When to use 

By coding these macros into your source listing you can ensure that a dump of 
the supervisor and of the partition issuing the macro is executed. 

For example, you may require a partition dump when certain conditions arise 
during program execution. This is accomplished by programming a branch to 
the DUMP (or JDUMP) macro written in the source listing. The JDUMP 
macro must be used when it is necessary to terminate the job after entering the 
routine that issued the macro. The DUMP macro is used when termination only of 
the job step is required, for example, during program testing. After termination of 
the job step in which the macro was issued the job steps after that are still 
executed. 




Serviceability Aids. 2.35 



Intentionally Blank 
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2.38 Serviceability Aids. 



Two series of trace routines are provided on the System/370: PDAIDS and 
SDAIDS 

These aids enable information to be obtained from the system at the time of a 
malfunction. They are aids for further error isolation, and are usually initiated 
during a rerun of a troublesome program after a first analysis of the problem. 
The type of trace to use for a particular problem depends on the result of the 
first analysis and how much more information is required to help in further 
isolation of the error. 

This section is divided into two parts: 

Part 1 describes the PDAIDS, and part 2 describes the SDAIDS. 



Trace Routines 

PDAIDS 




PART 1 PDAIDS 

General description 

There are four trace routines that can produce printed output of certain events 
which occur during the execution of programs. 

The trace routine will: 

• Record I/O operations (I/O trace) 

• Record the order in which phases and transients are called (Fetch/ Load trace) 

• Record the order in which supervisor calls (SVCs) are executed (Generalized 
SVC trace) 

• Record the order in which either an SVC or an SVC 31 , and I/O 
interrupts occur. (QTAM trace). 

On the occurrence of an event, an entry is generated which, by selection of the 
trace, can be recorded on magnetic tape, printed on a line printer, or preserved 
either in the PD area or, if specified, in an alternate area of real storage. 



Caution 

The effect on the operation of programs currently running in the system 
that are time dependent, for example, a program using MICR or teleprocessing 
as input/output, must be considered before using this serviceability aid. 
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Trace Routines 

PDAIDS 



System requirements 

Before any PDAID function can be executed, the following requirements must 
be met: 

• During the system generation, specify a minimum value of 1400 in the PD 
parameter of the FOPT macro. (The maximum value is 10,240). 

• If data provided by the trace routines is recorded on magnetic tape, use 
the PDLIST program after tracing is complete to obtain a printout of the 
tape. 

All PDAID modules are distributed by IBM in the relocateable library and must be 
cataloged into the core image library before execution. They are self- relocating for 
initialization in any real or virtual partition (6K or greater) of a multiprogramming 
system. 

Restrictions: More than one PDAID trace routine cannot operate concurrently. 
This also applies to the PDAID Transient Dump program described in Section 
2-A-4. Therefore, more than one program rerun must be executed if more than 
one PDAID function is used to gather information about a failing program. 



Using PDAID and SD AID concurrently: IF SDAID is active it must first be 
terminated before initiating a PDAID trace in core-wrap output mode in an 
alternate area. 



Modes of output 

Line printer: (not available as output mode for QTAM trace) Examples in this 
section show the trace outputs when the output device is a line printer. An 
asterisk on the print-out indicates that at least one event (trace entry) has been 
overwritten. This occurs when an overflow is caused in the trace table in the 
PD area (described in B-3) or in an alternate area. This may occur when the trace 
output device, or its control unit, or channel, is shared with other programs 
running simultaneously. 

If the printer is not ready or has an error condition, message 4C 2 4A NO I/O TO OD 
is printed on SYSLOG and the system waits for the END/ENTER key to be 
pressed after the printer is made READY. 

Magnetic tape: This mode of output collects and writes on an unlabled tape the 
trace entries that occur during execution of a job stream. 

The events are written on tape in core image (unprintable) format. 

The tape must be processed using the PDLIST utility. The tape unit must be 
assigned temporarily or permanently to s SYS005 ;and SYSLST assigned temporarily 
or permanently to a line printer in order to obtain readable listings of the events 
traced. Examples in this section show the output format after using the PDLIST 
utility. 

If the tape unit is not ready or has an error condition the message 

4C24A NO I/O TO OD 

is issued on SYSLOG and the system waits for the END/ENTER key to be 
pressed after the tape drive is made READY. 



2.40 Serviceability Aids. 



Core-wrap: This mode of output preserves a fixed number of trace entries in either 
the PD area buffer or an alternate area taken from the main page pool. If the 
alternate area is specified, the PD area buffer is not used. When the area is full, the 
oldest entry is overwritten by each new entry. 

When core-wrap in the PD area is specified, the PD area must be dumped. The 
dump should normally be executed on the occurrence of a system malfunction 
when the last few trace event entries are required to aid offline debugging. 
Dumping and locating the PD area is described under B-3 in this section. 

Table B-3 lists the length of each type of trace entry, the locations, and the 
maximum number of entries that can be preserved in the minimum PD area 
buffer size. Use the table and a dump of the PD area to locate the oldest and 
newest trace entries. 



Trace Routines 

PDAIDS 




Core-wrap in an alternate area: If many events are to be recorded in the core- 
wrap output mode and the PD area is considered to be too small, specify an 
alternate area large enough to contain the trace event entries. 

Specifying and dumping an alternate area is described under B-4 in this section. 

When an alternate area is specified, the real storage taken from the main page pool 
is returned to the main page pool on termination of PDAIDS. Before the alternate 
area is released, its contents are dumped on the device assigned to SYSLST. 
(See "Termination of PDAIDS .") 



When to use the core-wrap output mode: This output mode is useful when no 
output device is available, or when time required by the output operation is not 
available. This would be the case for example, when a PDAID output device 
interferes with time-dependent programs example, when a PDAID output device 
interferes with time-dependent programs using the I/O channels. It should also be 
specified when only the last few trace event entries are necessary to aid in offline 
debugging. (This reduces the task of searching through masses of output.) 

Terminating PDAIDS 

Any trace routine can be terminated by re-initializing the PDAID program with 
the job control statement // EXEC PDAID, and responding to the message 
PDAID= with XX. It is also possible to reset (terminate) one trace routine by 
loading another. 

Terminating core-wrap output in an alternate area 

When the core-wrap output is selected, SYSLST must be assigned to either a 
line printer, a tape unit, or a disk drive, before responding with XX to the 
message 4C10D PDAID=. 

For example: 

//ASSGN SYSLST, X'OOE' 
//EXEC PDAID 

If SYSLST is unassigned, the contents of the alternate area is overwritten when it is 

returned to the main page pool. 

PDLIST 

Whether the PDAID function uses a printer for its output device, or the PDLIST 

program prints the output of a tape unit, the data printed out is identical. 

PDLIST is initiated by the command: 

//EXEC PDLIST 

PDLIST then prints on SYSLST the contents of the tape reel (it can include the 

output of more than one PDAID function) mounted on SYS005 . No tape labels 

are required. 

Note: The data can only be printed using PDLIST if the device assigned to 
SYSLST is a line printer. 
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PDAIDS 



Description and operation 



Input/Output Trace 

This trace enables the I/O activity of programs run under DOS/VS to be recorded 
for offline analysis. The format of the data recorded in the PD area either in a 
trace table or, when using the core-wrap output mode in a rotating buffer, is as 
follows: 





Length of one entry = 1 


8 decirric 


I bytes 




On the occurrence of an I/O interrupt; 






I 
Device 
Adqir 


i I I I I I I 

I/O OLD PSW 
I I I I I I I 


I I I I I I I 

csw 
I I I I I I I 



On the occurrence of a START I/O instruction 



E2 40 



Device 
Addr 



CCB ADDR-R1 



i i r 
csw 



— Condition Code 

If the entry is made due to CSW stored 
on a START I/O instruction the CCW 
address in the CSW is set to zero. 

Notes: 

1. The PSW and CSW are described in E-2 of this Section. 

2. The CCB is described in chapter 6 of Section 4. 

3. General purpose register usage is described in chapter 10 of Section 4. 

4. The CCB address and the CCW address in the CSW are virtual addresses. 

Either of these occurrences is referred to as an I/O event. 

By selection of the trace output device, the event can be: 

• Recorded on magnetic tape 

• Printed on a line printer 

• Preserved in the PD area 

• Preserved in an alternate area 

When magnetic tape output is used, the tape must be processed by the PDLIST 
utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-l in this Section. 
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Trace Routines 

Tracing Options: The I/O trace function provides the following options: PDAIDS 

• Trace all I/O activity on the system. 

• Eliminate a maximum of three devices. 

• Limit trace to a maximum of three devices. 

The trace limiting options are specified by the initializer keywords IGNORE 
DEVICE= or TRACE DEVICE=. All I/O activity is traced if one of these key- 
words is not specified. The two keywords are mutually exclusive: when one is 
specified, the other becomes invalid. 

The trace limiting options are invoked by specifying the channel and unit 
addresses (X'CUIT or CUU) of the appropriate devices. Symbolic device 
references (SYSxxx) are invalid. 

Note: If the trace output device is being used by a problem or control program 
simultaneously with the PD AID program, I/O events for the PD AID program 
are ignored (not traced). Because of this, it is not necessary to ignore the trace 
output device. 

When to use: Use the I/O trace to check that the I/O interrupts within your 
system are correct during the execution of programs. 

You could use it, for example, in a multiprogramming system where the status 
of I/O units is suspected of causing incorrect I/O interrupts. An I/O trace output 
will inform you about the sequence of SIO/ I/O interrupts and about the 
status of I/O units at the time of interrupt. 

The next two examples show the output obtained from an I/O trace. 
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00E 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070F20000000090C 
OOE 070F20000000090C 
OOE 070F20000000090C 
OOE 070C20000000090C 
OOE 070F20000000090C 



1004094008000000 
1004094008000000 
100409*008000000 
1004094008000000 
1004094008000000 
1004094008000000 
1004094008000000 
0000000004000000 
0000000004000000 
000000 0C04000000 
0000000004000000 
0000000004000000 
0000000004000000 



OOE 070F20000000090C 0000000004000000 
OOE 070F20000000090C 0000000004000000 
OOE 070C20000000090C 0000000004000000 
OOE 070F20000000090C 0000000004000000 
OOE 070F20000000090C 0000000004000000 

ooe o7of. £n£<i/ o£c£. & khoooooo 
sio oooo sio <*a4**<J&*. i0800000 ° 

SIO 0000' ^^^^__^ 104000000 

/SIO OOOOi J0400000TS, 



SIO OOOOOOOE00040910 0000000004000000 



SIO OOOOOOOE00040910 0000000004000000 
SIO OOOOOOOE00040910 0000000004000000 
SIO 0000000E00040910 0000000004000000 



OOOOOOOE00040910 0000000004000000 
00O00OOEOO040910 0000000004000000 
OOOOOOOE"""' ""'" """"""0004000000 

ooooooo e "Asset- entity* 

0O0OO00E 






^\ 



070C20000000090C 100408B80C 000000 



070C20000000090C 1004094008000000"} 

070C20000000090C 1004094008000000 / £ tt £<Ji* 

070C20000000090C 1004094008000000 V -frvtn 

070C20000000090C 1004094008000000 / OOE 

070C20000000090C 1004094008000000 1 

070C20000000090C 1004094008000000 ' fifx /S /tr)\ 



An example showing an I/O trace output printed on a line printer used as the 
PDAID output device. 



P04REA 

009480 
009440 
0094C0 
0094E0 
009500 
009 520 
009540 
009 560 
009580 
009540 
0095CO 
0095E0 
009600 
009 620 
009640 
009660 
009680 
009640 
009 6C0 
0096E0 
009 700 
009720 
009 740 
C09760 
009780 
009740 
0097:0 
0397E0 
009 800 
009820 
03 9 840 
009860 
009880 
009B40 
009 8C0 
0098E0 
009900 
009920 
009940 
009960 
009980 
00994 
009 9" 
0099E0 



804000EO OOOOF600 FFFFFFFF FFFFFFFF 
0000=300 00000000 00000000 00000000 



00000000 00000000 
00000030 00000000 



S&/ f Pt> <Wt, 



)30j[022 



33301S3E 0000B44E 
1C9 C4C9E3E6J 



E3037EF3 F8F 07000 (000099FF 0000479C 

00003000 00004798 O0OO3AA4 000013 

FFFFFFFF FFFFFFFF FFFFFFFF 3 Fr , . 

FFFFF=80 800047AE 47F0915C 581 C/T^X ^/ ^/Xl^jC,^/ 

50C091C4 58400014 48AOA040 49; ^WX fT OUXsrUXOftX 

47F09084 95FF4002 4733910C 1B( <y / V 

00004111 000058:0 91C49120 10( /y^J^Oi. 

58B10020 19AB4740 90FE41CB 00' / 

600347=0 910CBFB7 B0454770 901 

07840704 49209038 078A070A 49; 

07843501 B00691C8 07845880 91B841BB 

91B307 = A 58B091B8 4400906B 502B0002 

0018424B 00029430 B0029120 10064710 

47F09110 58A1001C 50A80006 9133B332 

00009924 000099FC C4E4D400 00002330 

84F30333 OOOOOOOE 073F2333 33333962 

84FO0O0O 00000400 OOOOOOOE 070C2000 

20000000 09620000 00000400 0000E240 

000E070C poooonno 0962oooo aAFonaoo 

04000000 (E2400000 OOOEFFOO 8AF00300 






000000 096iU0<n) 
0E070C 20300000 
300300 E2430300 
008AFO 08000000 



000' 

FF0 £2¥0 » 
070 

000 

096 ^e</ on a. 
200 e , , , 
E2 4 dt**t I/O 
080 . y_- '. 

000 
370 

0000: i<t'l OUUOUOOfc FF008AF0 00033300 
84F33300 OOOOOOOE O73F?0OO 30300962 
84F00000 00000400 OOOOOOOE 070C2000 
20003000 09620000 00000400 3033E2V3 
000E070C 20000000 09520303 8AF00830 
04003000 E2400000 OOOEFFOO 8AF00300 
000034=0 08000000 OOOE070F 20000000 
FF0034=0 00000000 04000000 000E070C 
070F2000 00000962 00000000 34030330 
OOOOOOOE 07OC2O0O 00000962 30308AF0 
00000400 00OOE24O OOOOOOOE FF008AFO 
09623000 84F00800 OOOOOOOE 370F2000 



001259B0 91B1.4743 
501B0006 D2013000 
919C9130 B0024770 
47839192 47F090CA 
05E7FFFF OOOE070C 
00300030 040J 
000009>e-tJ0008Ai 

n03E FF008AF0 
5033303E 070F2 000 
00000430 OOOO pOOE 



-csw- 



,^__ 



f, 



„ ,r) V 



Coo C) 

0000U40O O000E240 
09623000 8AF00800 
OOOEFFOO 8AF00000 
OOOS070F 20000000 
04000000 OOOE070C 
00303330 04000030 
03003962 00008AFO 
OOOOOOOE FF008AF0 
0033003E 070F2000 
33303400 OOOOOOOE 
09620000 00000400 
20300330 09620003 
E24O0OOO OOOEFFOO 
08000000 000E070F 
00303030 04000000 
00300962 00000000 



00000000 00000000 
;2000000 00000200 



00flOC56--j0J2QC>9F 2 
*T r FF0009 FFFFF 
=FFFFFFF FFFFFFFF 
I03O00BA 5OA0905C 
»780910C 41AA0008 
)O8O5AC0 A024581: 
1FA70041 47809110 
I03C58B0 91B88EA7 
i8A0905C 49239036 
)01C0502 B00391C0 
915658B0 91B450B0 
91B350A0 905C88AO 
9110D702 BO0BB00B 
E2400000 00009654 
20000000 09620000 

One, fia&L enfav 

00033000 04000003 
00000962 00030000 
070C2000 00000962 

/3ea*n of m^ci 

04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 
09620000 
20000000 
E2400000 
08000000 
00000000 
00000962 
070C2000 
0O00E24O 
8 AF 00 8 00 
8AF00OOO 
20003000 
OOOE070C 
04000000 



000E070C 
04000000 
00008AFO 
FF008AFO 
070F2000 
00000005 
00000400 
09620000 
OOOEFFOO 
000E070F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 
0962 0000 
20000000 
00000000 



of /fcoo £u4& . 



....^ ^iPOAIDITHt 

Y.'.'o'. /%»*& Ma^nx, of 

..'.'.'. Z/O Ctt<j^ - trurfutC \\ 



.DUM NX. 



An example of an I/O trace executed in core-wrap output mode in the PD area. The 
PD area was dumped using the DUMP command. 



2.44 Serviceability Aids. 



Fetch/Load trace 

The F/L (fetch/load) trace records the order in which phases and transients are 
called from the core image library under the control of DOS/VS. Issuing a fetch 
or load causes an SVC 1 , 2 or 4, and the format of data recorded is as follows: 

Length of one entry = 22 decimal bytes 



Trace Routines 

PDAIDS 



i — r 



i — r 



PHASE NAME 

I I I l l 



Isvq 

No 



SVCADDR 

I I 



~~i — i — r~ 

LOAD ADDR 

I I L_ 



— I 1 r— 

ENTRY ADDR 

I I L_ 



JYstoO 



AR.BG, F4, F3, F2, F1 
See note 4. 



.Entry address to give 
control to the phase. 




Address at which 
the phase is loaded. 



Call Address (This is taken from 
the SVC old PSW; therefore it is 
actually 2 bytes past the calling 
address.) 



Value of the Supervisor Call (See note 3) 



Phase Name 



Notes: 

1. At times, SVC 5, 6, 11, and 14 branch directly into the supervisor fetch or 
load routine. These are traced whenever they occur, and appear in the 
output of the trace; however, the calling address and S VC values do not 
indicate the actual fetch or load. 

2. Use of the REQUEST key during the operation of the F/L trace may result 
in apparently erroneous data due to the supervisor action required to 
handle the request. 

In particular, supervisor calls that have already been recorded may not be 
completed, and part of the data put out by the specific phase may pertain 
to these incomplete SVCs. 

3. A list DOS/VS SVCs can be found in Section 4. 

4. The SYSLOG ID is described in appendix B. 

When the data is recorded in the PD area, either in a trace table or, when using the 
core-wrap output mode, in a rotating buffer, the two bytes used for the SYSLOG ID 
is recorded between SVC ADDR and the LOAD ADDR. 



Serviceability Aids. 2.45 



Trace Routines 

PDAIDS 



On the occurrence of an event, an entry is generated. By selection of the trace 
output device, the event can be: 

• Recorded on magnetic tape 

• Printed on a line printer 

• Preserved in the PD area 

• Preserved in an alternate area. 

When magnetic tape output is used, the tape must be processed by the PDLIST 
utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-l in this Section. 

Tracing Options: The F/L trace functions are: 

• Trace all SVC 1 , 2, 4, and certain SVC 5, 6, 1 1 , and 14 interruptions. 

• Limit the trace by partition (multiprogramming systems only). 

Trace limiting options are specified by the initializer keyword TRACE PARTITION= 

These options are useful only when the user runs several partitions at once, and does 
not wish to trace all of them. If only one partition is operating at a given time, the 
default (trace all partitions) allows both the single partition and the supervisor to 
be traced. 

When to use: Use the F/L trace if you are not certain which phases are required 
for a particular program, or in which sequence they are called by the program. 
From the trace output you can see where the phases were loaded and their 
entry addresses. In addition you can check the logical use of the phases for the 
program. 

The next two examples show the output obtained from an F/L trace. 



2.46 Serviceability Aids. 



Trace Routines 

PDAIDS 

















// JOB PDLIST 
_ MAP 
• // ASSGN SVS0O5,X»2/ 

// HTC REM.SYS0O5 
m ! // EXEC POL I ST 




DATE 12/06/73 


CLOCK 20/31/54 






ll» 




f/l Ureter on /8<f br£ 












£ ajul co/zn ft^Bofetf 






A | //BCLOSE 2 C-040B4A 


B6 L-0082E8 E-0082F0 


//BCL0S2 2 C-008406 BG L-0082E8 E-0082F0 


to utejC. 7n*cx. atc&vt 






//BE0J3 E C-040B4C 


BG L-0082E8 E-0082E8 


//8E0J4 2 C-00837C BG L-0082E8 E-0082F0 






• i //BEOJ7 2 C-0084BA 


BG L-0082E8 E-0082F0 


//BEOJ 2 C-008372 BG L-0082E8 E-0082FO 






_ 1 //BEOJSl 2 C-00847A 


BG L-0082E8 E-0082FO 


/JOBCTLA 4 C-00839E BG L-040078 E-041888 


/S [of' «e64e*& &0/34<2-Z 






/JOBCTLG 4 C-040958 
• 1 /JOBACCT 4 C-041AEO 


BG L-041888 E-041888 
BG L-041B80 E-041B80 


/JOBCTLN 4 C-040958 BG L-041888 E-041888 
/JOBCTLG 4 C-040958 BG L-041888 E-041888 






_ I /JOBCTLF 4 C-040958 
1 /JOBCTLJ 4 C-040958 


BG L-041888 E-041888 
BG L-041888 E-041888 


/JOBCTLG 4 C-040958 BG L-041888 E-041888 J 


(G( 17 kt) 




I//BOPEN 2 C-040B42 BG L-0082E8 E-0082FO I 
















An example showing an F/L trace output as printed on a line printer using 
PDLIST. (A tape unit was selected as output device for the PDAID.) 



DEBUGEX3 <- / 10/05/73 



rU 



00000333 — SAME — 

00000000 00000000 00000000 






-P.O.- 
009480 
009 4A0 
009 AC 
0094E0 
009 500 
009520 
009540 
009560 
009580 
0095A0 
0095CO 
009 5E0 
009 600 
009620 
009 640 
009660 
009680 
0096A0 
009 6C0 
009 6E0 
009700 
009720 
009740 
009 760 
009780 
009 740 
0097C0 
0097E0 
009800 
009820 
009 840 
009 860 
009 880 
009 840 
009 SCO 
009 8E0 
009900 
009920 
009 940 
009960 
009980 
009940 
0099C0 
0099E0 

LBLTYP 
— <=2-- 
081000 
09102 
091040 



Pi) a^ea, Q5ooc(§9F^ ooi 



AREA _ 

.., ^...^^^ 0000479C 

00000000 00006940 00003&T4 00001003 
90ECD202 B0090025 O2O0BOO8 008B07FA 
FFFFFF30 FFFFFFFF O7FA070A 07FA070A 
4710909A 95FF90F5 078A95FF 90F5078A 
078A53B0 90EC501B OOOC500B 00100207 
0201B014 80029502 B0084770 90CE4111 
90F04740 90E258B0 90E850B0 90EC07FA 
FFFFFFFF 5B5BC2C5 D6D1F340 OB008908 
F4400200 88860000 87C00000 87C8C6F2 
000087C8 C6F25B5B C2C5D6D1 F4400200 
D601F540 020087D4 000087CO 000087C8 
87C00030 87C8C6F2 5B5BC2C5 D601F540 
C2C5DS31 F4400200 881A0000 87CO0O0O 
000087CO O0O087C8 C6F25B5B C2C5D6D1 
5B5BC2:5 D6D1F540 020087D4 000087C0 
881A00OO 87COOOO0 87C8C6F2 5B5BC2C5 
C6F25B5B C2C5D6D1 F4400200 881A0O00 
02008996 000087C0 O0O087C8 C6F25B5B 
87C8C6F2 5B5BC2D7 C3C80240 02008A3E 
07400230 894 CD000 87C0000Q 87C8C6F2 



)00 00000000 00000000 . 



O000168E 
|D7:4C1C9 



PhaM. A/a**** 



000087C8 C6F2 15B5B C2C4D4D7 C2C30200 

07C50540 

87C 00300 

C20604i3 

000087C0 

5B5BC206 

89EE0300 

C6F25B5B 

0200802 

87C8CSF2 

O54O023B 

000087C8 

04E3F3=5 

87C00030 

C2C3:556 

O0OO87C0 

5B5BC2:3 

8A020300 

C6F2535B 

020B1732 

87C8C6F2 

FOF 50230 

000087C8 



FFFFFFFF 
47F09036 
95FF90F5 
B0005000 
0008501B 
00309534 
O00O87C0 
5B5BC2C5 
881AO00O 
C6F25B5B 
020087D4 
87C8C6F2 
F4400200 
000087C8 
D6D1F540 
87C000OO 
C2C506D1 
000087CO 
5B5BC2C4 



4j/0O0 
E^FFF 



O000B44E/ 0O0O0C56 00009F02 
C4C6E3E6|FFFF0009 FFFF5880 




0J5 



B8EE0000 




FFFFFFFF FFFFFFFF FFFFFFFF 

428090F5 58800080 91018042 

078A95FF 90F5078A 95FF90F5 

58800014 4880805A 4A8090F4 

OO10581B 000C41BB 001659B0 

0000973C 00D099FC 0040FFFF 

000087CD C6F25B5B C2C5D601 

D6D1F540 02008704 000087C0 

87COO0OO 87C8:6F2 5B5BC2C5 

C2C506D1 F4400200 881A0000 

000087C0 000087C8 C6F25B5B 

5B5BC2C5 D6D1F540 020087D4 

881A0000 87C00000 87C8C6F2 

C6F25B5B C2C5D6D1 F4400200 

020087D4 000087m nnnno-rm 

87C8C6F2 5B5BC2 Q^ fc^ e»j£l 

40400200 885E00 „ /•„ ' s /- ^ f- 

000087C8 C6F25B /* C 2 Z 6c^^ 

E4D407C2 02008AAQ» 000087CO 

87C0000O 87r.B:6FJI 5B5BC2D6 



.££BE0J3 . 

HF2 

HF2££BE0J4 .. 



HF2t£BE0J5 



BE0J4 



HF2££BEOJ 



££8E0J5 



6<j/&>) 



*M. 



...HF2fe£B0MPBj 
PEN 



F2££BE0J 

££BE0J5 ...M.... 

HF2££BE 

F2££BE0J4 

...M HF2££ 

.HF266BE0J5 ...M 

4 HF2 

...HF2££BE0J4 .. 

0J5 ...M H 

HF2££BEOJ7 

BEOJ 

.......HF2££BDUM 

££BDUMPB. 



....HF2K SB0 



bb5BL2C3 
12C20000 
C6F25B5B 
O20089EE 
87C8C6F2 
E5F1020B 
000087C8 
D306E2F2 
87C00000 
C2C3D3D6 
000087C0 
5B5BC206 
89EEO0OO 
C6F25B5B 



D306E2C5 
87COOOO0 
C2D607C9 
0O0O87C0 
5B5BC206 
31 5A000O 
C6F25B5fa 
020C89CE 
87C8C6F2 
E2C50200 
003087C8 
D7C9C7D5 
87COOOOO 
C206D7C5 



O2OO8A90 
87C8C6F2 
C7D50400 
O00O87C8 
D7C5D5F1 
87COOO00 
C2C3D306 
000087CO 
5B5BC2C3 
8A900000 
C6F25B5B 
04008946 
87C8C6F2 
D5F10200 



HEX LENGTH IS 0000 

[D7C8C1E2 C55C5C5C 074D3000 000B1718 
D7C8:iE2 A00B16EE 0OOB32A8 0000001B 
00000330 00000000 00000000 00000000 



M»** Sen alllm 

87COOO0O 

000087CO 000087C8 C6F25B5B C2D607C5 

5B5BC2D6 D7C5D5F1 02008862 000087CO 

89460000 87C00000 87C0C6F2 5B5BC206 

C6F25B5B C2D607C5 05400200 89220000 

02008862 000087CO 0000B7C8 C6F25B5B 

87C8C6F2 5B5BC2C3 D4E3F0F1 02008.986 

E2C5020B 17C20000 87C00000 87C8C6F2 

000087C8 C6F25B5B C2C3D3D6 E2F30200 

D4E3F0F5 02008882 000087CO 000087C8 

87CO00O0 87C8C6F2 5B5BC2D6 D7C5D540 

C20607C5 D5F10200 88620000 87C0OO0O 

000087CO OO0O87C0 C6F25B5B C2D6D463 

5B5BC206 D7C5D540 02008922 000087CO 

88620000 87C00000 87C8C6F2 00000000 



00000000 00000000 403B107A 0003207A 
000B1910 00000049 00003002 0000002E 
00008450 5E0E6CAF 00000000 00000000 



F2££B0P£N1. 
HF2££B0PIGN .F2££ 



BOHT05 

HF2££B0PE 

££B3PIGN 

HF2££BC 

F2££BCL0S2 

...< HF2££ 

,HF2££BCL0SE.... 

N ...B HF2 

...HF2££B0PIGN.. 

HT05 ,....H 

HF2££B0PEN1 

BCEOtfl 

HF2££BCL0 

££BCL0S2 

.K HF2£tBC 

F26£BCL0SE 

...< HF2CE 

,HF2££B0PIGN.... 

05 HF2 

...HF2££80PEN1.. 



.HF2££BOPEN .... 

Nl HF2 

. ...F26CB0UR01.. 

LOSE H 

HF266BCL0S3 

3CMT05 

HF2C6B0PE 

££B0PEN1 

...F2££B0 

F2££B0PEN 

HF2££ 

,HF2££BCMT01.... 

SE...B HF2 

...HF2££BCL0S3.. 

MT05 H 

HF2££B0PEN 

B0PEN1 

F2££B0HT 

££B0PEN 

HF2.... 



PHASE*** 
PHAS.... 



m 



An example showing the PD area in a system dump after executing the F/L trace 
in core-wrap output mode in the PD area. 



Serviceability Aids . 2.4' 



Trace Routines 

PDAIDS 



Generalized Supervisor Call trace 

The GSVC trace records SVC interrupts as they occur. All SVCs, or a selected 
group of SVCs, may be traced, The format of the data recorded in the PD area 
either in a trace table or, when using the core-wrap output mode, in a rotating 
buffer, is as follows: 



Length of one entry = 18 decimal bytes 



i i i i i I r 

SVC OLD PSW 

J I I I l I L 



GR© 



SVC 
Mo, 



i — r 

GR1 



SYSLOG 
ID* 



■*► AR 
BG 
F4 
F3 
F2 
F1 



See note 5 



The contents of general purpose register 1 



Value of the Supervisor Call, (See note 3.) 



The contents of general purpose register 0. 



Notes: 

1. IfPTO=YES in the FOPT macro, then SVCs issued when the physical 
transient area is busy are not traced. 

2. The PSW is described in E-2 of this Section. 

3. A list of DOS I VS SVCs can be found in Section 4. 

4. General purpose register usage is described in Section 4. 

5. The SYSLOG ID is described in appendix B. 



2.48 Serviceability Aids. 



Trace Routines 

On the occurrence of an event, an entry is generated. By selection of the trace PD Al DS 

output device, the event can be: 

• Recorded on magnetic tape 

• Printed on a line printer 

• Preserved in the PD area 

• Preserved in an alternate area. 

When the magnetic tape output is used, the tape must be processed by the 
PDLIST utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-l in this Section. 

Tracing Options: The GSVC function provides the following options: 

• Trace all SVCs that occur. 

• Trace up to six SVCs selectively. 

• Eliminate up to six SVCs selectively, and trace all others. 

• Trace all partitions. 

• Trace up to five partitions selectively. 

SVC limiting options are specified by the initializer keywords IGNORE SVC= 
or TRACE SVC=. All SVC activity is traced if one of these option keywords is 
not specified. The two keywords are mutually exclusive: when one is specified, 
the other becomes invalid. 

The partition limiting options are specified by the initializer keyword TRACE 
PARTITION^ This is useful only when the user must run several partitions at 
once, and does not wish to trace all of them. 

When reading the output from this trace routine you may see more SVCs listed 
than expected. This is because an SVC already traced and recorded may be reset by 
the supervisor SVC routine, and then re-issued by the program being traced. For 
example, your program may issue an SVC 0, which is traced. But the channel 
queue may be full at that point in time, and so the supervisor can not handle the 
SVC 0. When your program has control again it will issue the SVC which will of 
course be traced again. 

When to use: Use the GSVC trace when a particular SVC issued by a troublesome 
program is suspected of causing the errors. 

The values of registers and 1 are printed on the trace output and these can be 
important for certain SVCs. 

The trace output also shows the current PSW at the time the SVC was issued. 
Therefore, the instruction and routine issuing the SVC in the program can be 
located. 

The next two examples show the output obtained from a GSVC trace. 




Serviceability Aids. 2.49 



Trace Routines 

PDAIDS 



// ASSGN SYS005t X>2A1' 
// MTC REW.SYS005 
// EXEC POtlST 



SVC *4//Sh/ 



9*0 



Svco 
/39 /Us&Z*, 



j PStH070D100000008376ro-(000092CO| H000092c5J^0^^^ 1pSW-07l0200000040B'»A 0-00040844 1-00041508 N-02 T-BG 
PSW-070D10000000831C 0-00040844 1-000004AO N-21 T-BG PSW-0 700000000008484 0-00040844 1-00041488 N-1A T-8G 
PSW-070D0000000084D6 0-00040B44 1-000082E8 N-02 T-BG | PSW-070D000000008304 0-00040844 1-000004AO N-21 T-BG 



PSH-0700000000008422 0-00040844 1-000004AO N-OB T-BG PSW-0710200000040B4C 0-00040B44 1-00041488 N-OE T-BG 
PSW-070D0000000082FC 0-00040B44 1-000004A0 N-21 T-BG PSW-070D00000000837C 0-00040B44 1-0O0082E8 N-02 T-BG 
PSW-0700000000008306 0-00040B44 1-000004AO N-21 T-BG PSW-0 7002000000084BA 0-00040B40 1-000082E8 N-02 T-BG 




5/c X't*' 



An example showing a GSVC trace output as printed on a line printer using PDLIST. 
(A tape unit was selected as output device for the PDAID.) 



03F980 

03F9AO 

03F9C0 

03F9E0 

03FA00 

03FA20 

03FA40 

03FA60 

03FA80 

03FAA0 

03FAC0 

03FAE0 

03FBO0 

03FB20 

03F840 

03FB60 

03FB80 

03FBA0 

03FBC0 

03FBE0 

03FC00 

03FC2O 

03FC40 

03FC60 

03FC80 

03FCA0 

03FCC0 

03FCE0 

03FDO0 

03FD20 

03FD40 

03FD60 

03F080 

03F0A0 

03FDC0 

03FOE0 

O3FE0O 

03FE20 

03FE40 

03FE60 

03FE80 

03FEA0 

03FCC0-- 

03FEE0 

03FF00 

03FF20 

03FF40 

03FF60 

03FF80 

03FFA0 

03FFC0 

03FFE0 



TERMTONS 

22560000 
00000004 
C2C7071D 
00040808 
00040CA9 
000422EE 
07103000 
0910C2C7 
O0OB07O4 
22DC0000 
00000004 
C2C70710 
07040808 
00040CA9 
00042256 
071D0000 
0820C2C7 
0CA90004 
22C40000 
00000004 
C2C7071D 
00040910 
000000 IB 
000422EE 
07100000 
0808C2C7 
OCA90004 
224C0004 
30000004 
C2C7071D 
07040910 
00O0000B 
000422C4 
07100000 
0910C2C7 
00180004 
22560000 
00000004 
C2C70710 
00040808 
00040CA9 
000422EE 
OUO3000 
0910C2C7 
00OB07O4 
22OCO000 
00000004 
C2C 70710 
070408D8 
00040CA9 
0004201 A 
00000000 



12/06/73 

001B0704 08D8C2C7 
22560004 0CA90704 
00000004 22560004 
C2C70 71D 00000004 
00040910 C2C70710 
00000008 00040910 
00042202 00000008 
07103000 000422EE 
0910C2C7 I071D3000 
0O0B0704 
22E80000 0( 
30000004 2 
C2C70710 II 
070408D8 C2CT0flU 
00040CA9 070408D8 
00042256 00040CA9 
07100000 0004201A 
0910C2C7 07103000 
00060704 0910C2C7 
22DCO000 000B07O4 
00000004 22C40000 
C2C70710 00000004 
00040910 C2C7071D 
00000018 00040910 
00042256 0000001B 
07100000 00042256 
08D8C2C7 07100000 
0CA90004 0808C2C7 
22D20004 0CA9000 
30000004 22EE0000 
C2C70710 30000004 
07040910 C2C7071D 
00000008 07040910 
000422DC OOOOOOOB 
071D0000 000422E8 
0910C2C7 071D3000 
00180704 0808C2C7 
22560004 0CA90704 
00000004 22560004 
C2C7071D 00000004 
00040910 C2C70710 
OOOOOOOB 00040910 
-00042202 OOOOOOOB 
07103000 000422EE 
0910C2C7 071D3000 
000B0704 0910C2C7 
22E80000 001B0704 
30000004 224C0000 
C2C7071D 10000004 
07040808 C2C7071D 
00040CA9 07040820 
00000000 00000000 



071D1000 
08D8C2C7 
0CA90704 
22560004 
00000004 
C2C 70710 
00040910 
00000008 



fS VC face o*t a&/6<tts4t%&*t4 Jn -eat^e.-^f^. page 12 



0004224C 00040CA9 00040808 C2C70710 

07101000 0004224C 00040CA9 00040808 

08D8C2C7 07101000 0004224C 00040CA9 

0CA9O7O4 0808C2C7 071D300"> *""" "* ?"" 

220C0004 OCA90704 0910C2C One, baits 

00000004 22C40000 0O0BO7C/ Ar~ 

C2C70710 00000004 22DC00<f Vn*Jf 

00040910 CZC7071D onaaartU 22040000 



.OBG 

....BG. 



00042202 






BG.... 
....BG. 



*m~. 



Svc 04/fsw 



SVCO' 



100UU004 

C2C7071D 
07040808 
00040CA9 
000422EE 
071D3000 
0910C2C7 
00080704 
220C 0000 
00000004 
C2C70710 
07040808 
00040CA9 
00042256 



0001B 00040910 
42256 00000018 

sysLoq id 00000 00042256 

iittuwt umfuuui uol)8C2C7 07100000 
00000004 224C0004 0CA90004 0808C2C7 
C2C70710 00000004 20100004 0CA90004 
07040820 C2C7071D 30000004 22D20004 
OOOOOOOB 00040910 C2C7071D 00000004 
00042202 OOOOOOOB 00040910 C2C70710 
07103000 000422EE OOOOOOOB 00040910 
0910C2C7 07103000 000422D2 OOOOOOOB 
00080704 0910C2C7 07103000 000422EE 
22E80000 001B0704 0910C2C7 07103000 
30000004 224CO000 00180004 0808C2C7 
C2C70710 10000004 224C0004 0CA90004 
07040808 C2C7071D 10000004 224C0004 
00040CA9 07040808 C3X7071D 10000 004 
00042256 00040CA9 (07040808 C2C7i )71D 
07100 - 



..QBG... 
..OBG. 



22D20000 0008000' ^»^«e«eW<W ■&* S ^ C 7 ' 

30000004 22EE00OI « <? V 

C2C70710 30000004 22020000 000BO0O4 09I.OTJ2C7 

07040910 C2C7071D 30000004 22EEOOO0 001B0004 

0000001B 07040910 C2C70710 30000004 22EE0000 

0004224C 0000001B 000408D8 C2C70710 00000004 

071DOOOO 0004224C 00040CA9 00040808 C2C7071D 

0808C2C7 07101000 0004224C 00040CA9 00040808 

0CA907O4 0808C2C7 071D1000 0004224C 00040CA9 

22560004 OCA90704 0808C2C7 07103000 00042202 

00000004 22DC0004 0CA90704 0910C2C7 07103000 

C2C 70710 00000004 22C40000 O00BO704 0910C2C7 

00040910 -C2C7071D 00000004- 22OC000O 00 080 704 

OOOOOOOB 00040910 C2C70710 00000004 22C40000 

000422D2 OOOOOOOB 00040910 C2C7071D 00000004 

07103000 000422EE 00000018 00040910 C2C70710 

0910C2C7 071D3000 000422EE 0000001B 00040910 

00180004 08D8C2C7 07100000 00042256 000000 IB 

224C0004 0CA90004 08D8C2C7 071DOOOO 00042256 

00000004 20100004 0CA90004 0820C2C7 07100000 

C2C7071D 00000004 224C0004 OCA90004 0808C2C7 

00000000 00000000 



.086....- 
QBG 



of? en£<6i a^a. ■•■ 
Sysco c Z6.(SP 




.oeij 6$ x 

— •/ AX ?Z F3 ff) 



An example showing a GSVC trace in core-wrap output in an alternate area. The 
alternate area is dumped on termination of PDAID and is given back to the main 
page pool. (The beginning of the alternate area is not shown). 



2.50 Serviceability Aids. 



QTAM Trace 

This trace records the sequence of SIO instructions issued to channels and devices. 
The data recorded is similar to that of the I/O trace, but gives more details about 
the type of I/O interrupt. 

This routine is designed to trace programs running in real mode. However, it can be 
used to trace virtual mode programs provided the following is considered when 
reading the trace output: 

• If the program being traced is running in real mode the CCB address and the 
CCW address in the CSW are real addresses. 

• If the program being traced is running in virtual mode, the CCB address and 
the CCW address in the CSW are, respectively, the address of the CCB copy 
block. (Refer to Section 4 Chapter 13 for a description of CCB and CCW 
copy blocks.) 

There are three types of trace events and each type is recorded, having a prefix 
that defines the type. 

The data is recorded in the PD area, either in a trace table or, when using the 
core-wrap mode of output, in a rotating buffer. The format of the data recorded 
is as follows: 

• On the occurrence of an SVC interrupt; 



SVC 

No. 



i — i — i — i — i — r 

SVC OLD PSW 

J I ! I I _L 



GRO 
J I L 



1 — r 



GR1 
J L_ 



SYSLOq 
ID* 



Prefix V 
X'E5* 



AR 
BG 
F4 
F3 
F2 
F1 



Trace Routines 

PDAIDS 



- (See note 5.) 



- General purpose register 1 
General purpose register O 



(See note 4) 



-► Value of the Supervisor Call (See note 2.) 



• On the occurrence of an SIO instruction 



1 — r 



i — I 1 — r— 

CSW 
l I l I I I i 



1 1 i 1 

FF FF FF FF FF 



Device 
Addr 



I I " 
CCB ADDR 
_l I L_ 



Prefix S 
X'E3' 



Condition code 



Not used 



• 


On the occurrence of an I/O interrupt; 






1 


Device 
Addr 


1 1 1 1 1 I 1 

I/O OLD PSW 
I i i l 1 il 


till III 

CSW 
1 i 1 t l l t 


1 
FF FF 

1 










1 
Mot usee 



Prefix I 
X'C9' 

Notes: 

1. The PSW and CSW is described in E-2 of this Section. 

2. A list of DOS I VS SVCs can be found in Section 4. 

3. The CCB is described in Section 4. 

4. General purpose register usage is described in Section 4 

5. The SYSLOG ID is described in appendix B. 

Any of these occurrences is referred to as an event. On the occurrence of an 
event, an entry is generated. 



Serviceability Aids. 2.51 



Trace Routines 

PDAIDS 



By the selection of the trace output device, the event can be: 

• Recorded on magnetic tape 

• Preserved in the PD area 

• Preserved in an alternate area. 

When magnetic tape output is used, the tape must be processed by the PDL1ST 
utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-l in this Section. 

Tracing Options: The QTAM trace function provides the following options: 

• Trace all SVC and 3 1 , SIO ; , and I/O interrupts. 

• Trace SVC and 31 , SIO, and I/O interrupts from any three devices. 

• Ignore SVC and 31, SIO, and I/O interrupts from and three devices. 

• Trace in all partitions 

• Selectively trace up to five partitions. 

Trace limiting options are specified by the initializer message parameters 
IGNORE DEVICE= or TRACE DEVICE=. (The device options are invoked by 
specifying the three devices to be traced or ignored.) All SVC and 31 , SIO, 
and I/O interrupt activity is traced in all partitions of core if one of these 
options is not specified. They are mutually exclusive: when one is specified, the 
other becomes invalid. 

The partition limiting options are specified by the initializer keyword TRACE 
PARTITION^ 

When to use: Use the QTAM trace to check the sequence of SIO instructions 
to the channels and devices. Use this trace if you suspect errors in I/O interrupt 
handling routines or in program routines issuing SVC and SVC 31 , or if you 
suspect errors in the sequence of I/O interrupts being returned from channels 
or devices. The next two illustrations are examples of output from a QTAM 
trace. 

The next example shows a dump of the real address area containing trace output 
when the core-wrap output mode in an alternate area is selected. 



2.52 Serviceability Aids. 



Trace Routines 

PDAIDS 



TERHKEN 



12/06/73 



<\ 



^ 



GR 0-7 
GR 8-F 
FP REG 
CR 0-7 
CR 8-F 



03F800 
03F820 
03F840 
03F860 
03F880 
03F8A0 
03F8C0 
03F8E0 
03F900 
03F920 
03F940 
03F960 
03F98O 
03F9AO 
O3F9C0 
03F9E0 



sf 



03FAQD_ 
.^-0"3Ta2O 



03FA40 
03FA60 
03FA80 
03FAA0 
03FAC0 
03FAE0 
03FB00 
03FB20 
03FB40 
03FB60 
03FB80 
03F8A0 
03FBC0 
03FBE0 
03FC00 
03FC20 
03FC40 
03FC60 
03FC80 
03FCAO 
03FCC0 
03FCE0 
03 F 000 
03FD20 
03FD40 
03F060 
03FD80 
03F0A0 
03FOC0 
03FDE0 



8004080C 000*1500 0003F800 00000000 
B00400A4 900*1086 00000000 182F07F1 
00000000 00000000 00000000 00000000 
004000FF 0000E640 FFFFFFFF FFFFFFFF 
OOOOFFFF 00000000 00000000 00000000 



00000050 0004108* 00042084 00040FB8 
00040078 40040084 0003FFF5 08041518 
00000000 00000000 00000000 00000000 
00000000 00000000 00000000 00000000 
00000000 00000000 C2000000 00000200 



FTJOCOOOO 
0130070F 
04000000 
09070F20 
OOOOOOFF 
070F2000 
OOOOFFFF 
OF200000 
OOFFFFFF 
20000000 
FFFFFFFF 
00000009 
FFFFFFFF 
A01000E7 
00FFFFC9 



0F200000 
OOFFFFFF 
20000000 
FFFFFFFF 
00000009 
FFFFFFFF 
0000090C 
FFFFFFC9 
00090COO 
FFFFC900 
090COOOO 
FFC90009 
OCOOOOOO 
C9000907 
60084000 
0130070F 
04000000 



0009OCO0 
FFFFC961 
090COOOO 
FFC90130 
OCOOOOOO 
C9000907 
00000000 
00090 70F 
00000004 
09070F20 
00000400 
070F2000 
00040000 
OF200000 
50FFFFFF 
20000000 
FFFFFFFF 



003AF00C 
300 70C2 
00000400 
070F2000 
00040000 
0F20O00O 
04000000 
20000000 
OOOOOOFF 
00000009 
OOOOFFFF 
0000090C 
00FFFFE2 
00090C10 
FFFFC901 
090C0000 
FFC90130 



OOOOOOFF 



00000009 
OOOOFFFF 
00000 90C 
00FFFFE2 
00090C10 
FFFFE200 
090C1000 
FFE20000 
OC 1000 76 
E2000009 
100076C8 
00000900 
00E76008 
30070C20 
00000400 
070F2O0O 



Tfj:20001 
0C00003A 
E2000130 
0O0087A0 
00000900 
0078D008 
00090000 
79380800 
09000076 
60080000 
0000 76C8 
08400000 
0OE6C800 
400050FF 
00000009 
OOOOFFFF 
0000090C 



FFF 

090CTOOO" 
FFE20001 
0C000087 
C9013007 
00000000 
0009070F 
003AF00C 
30070F20 
OOOOOOFF 
07OF20OO 
OOOOfFFF 
0000 39A0 
08000000 
0039AOOO 
OOOOOOFF 
00000009 
FFFFFFFF 
0000090C 
FFFFFFC9 
00O087A0 
FFFFC901 
00000004 
FFE20001 
OC000087 
E20002A2 
00O0E838 
O130070F 
OCOOOOOO 
01300000 
3AF00C00 



DO 01300000 



3AC00800 
30000039 
AOOCOOOO 
OC200000 
04000000 
20000000 
OOOOOOFF 
00000009 
FFFFF'FFF 
0000090C 
FFFFFFC9 
000087A0 
FFFFC901 
00000004 
FFE20001 
0COOO03A 
C9013007 
00000000 
0130070F 
OCOOOOOO 
3O070F20 
OOOOOOFF 
30000039 
AOOCOOOO 
0000E6C8 
OC000012 
20000000 
FFFFFFFF 
39AOOO0O 
OOOOFFFF 



39A00OOO 

0060FFFF 

AOOOOOOO 

00FFFFE2 

00090C00 

FFFFE200 

090C0OO0 

FFE20001 

0C00003A 

C9013007 

00000000 

0130070F 

OCOOOOOO 

30070F20 

OOOOOOFF 

30000039 

FOOCOOOO 

OC200000 

04000000 

20000000 

FFFFFFFF 

00000009 

FFFFFFFF 

AOOOO 

OOFFF 

000087' 

FFFFE200 

O9OC00O0 

FFC90130 

87AO0COO 

E 2000 130 



3AF0OCO0 OOOOFFFF FFFFF'Ffc9 



C9013007 
00040000 
00013000 
003AC008 
01300000 
00000400 
30000039 
FOOCOOOO 
0C2 00000 
04000000 
20000000 
FFFFFFFF 
00000009 
FFFFFFFF 
A000003A 
00FFFFE2 
00090C00 
FFFFE200 
09OCOO00 
FFC90130 
OCOOOOOO 
C9013007 



OF200000 
OOFFFFFF 
0039AOOO 
OOOOOOFF 
39AO000O 
OOOOFFFF 
A000003A 
00FFFFE2 
00090C00 
FFFFE200 
090C0000 
FFC90130 
OCOOOOOO 
C9013007 
FOOCOOOO 
00013000 
003AC008 
01300000 
87AO0COO 
070C2000 
00040000 
0F200000 
OOFFFFFF* 



00090COO 
FFFFC901 
0087 AOOC 
FFC90130 
00000400 
C9013007 
FOOCOOOO 
00013000 
003AC008 
01300000 
87A00CO0 
070C2000 
00040000 
OF200000 
OOFFFFFF 
0039AOOO 
OOOOOOFF 
39AOO0O0 
OOOOFFFF 
0000090C 
00FFFFE2 
0O090CO0 
Tf=«C901 



30000039 
C0080000 
000039AO 
OCOOOOOO 
00780000 
OOOOOOFF 
79380000 
OOOOFFFF 
60000000 
00FFFFC9 
00000000 
FFFFC900 
00000004 
FFE20001 
0C00003A 
E2000130 
00003AF0 
0130070C 
00000004 
30070F20 
OOOOOOFF 
070F2000 
OOOOFFFF 
0F2000O0 
OOFFFFFF 
0039AO00 
OOOOOOFF 
39A00000 
OOOOFFFF 
0000090C 
00FFFFE2 
00090C00 
FFFFC901 
003AF00C 
FFC90130 
00000400 
E2000130 
00003AC0 
00013000 
003AFO0C 
30070F20 



A000003A 
00FFFFC9 
OOOOOOOO 
FFFFC900 
00000004 
FFC90009 
00000400 
C9000907 
00040000 
0009070F 
04000000 
09070F20 
OOOOOOFF 
30000039 
C0080000 
000039A0 
OCOOOOOO 
20000000 
OOOOOOFF 
00000009 
FFFFFFFF 
0000090C 
FFFFFFC9 
00090COO 
FFFFC901 
003AF00C 
FFC90130 
00000400 
E2000130 
00003ACO 
00013000 
003AF00C 
30070F20 
OOOOOOFF 
070F2000 
OOOOFFFF 
O00039A0 
08000000 
0039A00O 
OOOOOOFF 
OOOOC 



370D 



OOOOOOOO 



10700000 



3AF( 
070F 
OOOC 
000( 



■svco 



?<Zp f** 



SVC <&/>sv 

JaM, envy/ 



Sysuoa xj> 



PPM6 QTAtf fct<e. PAGE ! 




03FE00 
03FE20 
03FE40 
03FE60 
03FE80 
03FEA0 
03FECO 
03FEE0 
03FF00 
03FF20 
03FF40 
03FF60 
03FF80 
O^FFAO 
03FFC0 
03FFE0 



TERMKEN 

070F2000 
OOOOFFFF 
000039AO 
OCOOOOOO 
00E6C800 
000001FF 
E6C81000 
0001FFFF 
C81000E7 
01FFFFE2 
00090C00 
FFFFC901 
003AF00C 
FFS20001 
OC00003A 
OOOOOOOO 



0000090C 
FFFFFFC9 
00003AFO 
FFFFE500 
0087A00C 
FFE50000 
E8380C00 
E5000007 
600COOOO 
00013000 
003AF00C 
30070F20 
OOOOOOFF 
30000039 
FOOCOOOO 
OOOOOOOO 



12/06/73 

000087A0 
0130070F 
OCOOOOOO 
00071000 
OOOOOOFF 
07100000 
0001FFFF 
10000000 
01FFFFFF 
0039A010 
OOOOOOFF 
00000009 
FFFFFFFF 
A000003A 
00FFFFE2 
OOOOOOOO 



OCOOOOOO 
20000000 
FFFFFFFF 
00000415 
FFFFFFFF 
00041542 
FFFFFFC9 
041542A0 
FFFFC902 
00E8380C 
FFE20001 
0C00O03A 
C9013007 
FOOCOOOO 
00013000 
OOOOOOOO 



FFFFE200 
090C0O00 
FFC90130 
42A00410 
C902A207 
A004106C 
02A2070F 
04106C00 
A2070F20 
000001FF 
30000039 
FOOCOOOO 
0F200000 
OOFFFFFF 
0O39AO0O 
OOOOOOOO 



01300000 
3AFOOC0O 
070F2000 
6C000414 
OF200000 
00041488 
20000000 
041488C2 
00000009 
FFFFFFFF 
A000003A 
00FFFFE2 
00090COO 
FFFFC90 1 
003AF00C 
OOOOOOOO 



39A00OO0 
OOOOFFFF 
0000090C 
88C2C7E2 
00090C10 
C2C7E200 
090C1000 
C7E20002 
0C1000E8 
C9013007 
FOOCOOOO 
00013000 
003AF00C 
30070F20 
OOOOOOFF 



87A00COO 
E2OO013O 
000087AO 
0002A200 
00E8380C 
02A20000 
E7600COO 
A20000E6 
38OC000O 
OF200000 
OOFFFFFF 
0039A000 
OOOOOOFF 
00000009 
FFFFFFFF 







































I 










H..X- 


....1 




.r.... 

















An example showing a dump of the alternate area used for a QTAM trace in core- 
wrap output mode. 



Serviceability Aids. 2.53 



Trace Routines 

PDAIDS 



015900 
016920 
015940 
01S960 
016980 
0159A0 
0169C0 
0169E0 
016400 
015420 
015A40 
016460 
016&80 
015440 
016 4C0 
016AE0 
016B00 
016B20 
016840 
015B60 
015B80 
016840 
015BC0 
01S5E0 
016C00 
016FE0 

-P.D.- 
009480 
003 44 
0094C0 
005450 
0095 00 
009520 
009 540 
009560 
009580 
009 54 
0095C0 
0095 c 
009600 
009620 
009640 
039660 
009680 
009 64 
0096CO 
0096F0 
009 700 
009 720 
009 74 

oogg^o 

IBLTYP 
— 3G-- 
043000 
040020 
043040 
040060 
043380 
04004 



0OOOO00E 
8 31 0;2: 7 
EEEE0i:8 
00003008 
00000300 
00020303 
8310:2:7 
EEEE0i:8 
00000308 
00000300 
00020007 
0000303= 
OOOOOOOE 
EEEE0165 
EEEE0134 
87878787 
00000007 
000002:8 
EEEE0196 
EFEE0134 
87879787 
00000007 
000002:0 
80008420 
00003330 
00000000 

AREA 

00003300 

FFFFFFCC 

FFFFF=30r 

078A4i00 

90BC42:0 

91010734 

58700014 

402 09132 

92FF8010 

91023334 

91765880 

00805930 

91C44198 

00006 3.60 

0O04?334 

90B7934: 

47F 09246 

49309333 

95FF903C 

4C709232 

41509134 

00000300 

00000300 



O0OOF728 08000000 0000F718 

80006690 71006700 20OE2880 

47000000 00008A66 00081010 

0001 64C0 O0O087OA 00000030 

80008860 A0008944 000087C0 

00000007 00008B60 00000017 

80006690 71006700 20OE2880 

47000000 00008AB6 00081010 

00O164EO 000087DA 00000030 

80008860 A0008944 000087C3 

00000007 00008B60 00000017 

00000000 04000000 0300F719 

00000000 04000000 O0OOF7A8 

07OC2000 00000962 00001013 

040C2000 000009BC 00001013 

80808080 80838080 80808083 

00008860 00000017 03008848 

00040000 00003AB4 000004AO 

47000000 00008AB6 00081010 

040C2000 000009BC 00001013 

80808080 80838080 80808083 

00008B60 00000016 00008848 

00040000 O0003AB4 000004A0 

000004AO 000087CO O0OO87C0 

00000000 ^^ ST Bjf^ °/ 

IQOJ0099FF 0000479C 

00004798 00003AB't 00031333 
|0003F800||0003FFF5k 3F0EFFFF 



r 



'^(aH ana/ £^nd 



91C492C9 
801C9200 
00155980 
00009488 
00041020 
91809058 
0203913C 
47809155 
47809298 
43709232 
58690000 
--SAME-- 
00000000 



80000201 
91579878 
91C84740 
0003F800 
909F9048 
471O920A 
922647F0 
49309034 
5850903C 
1A755050 
47F0926E 



800100BA 
91B8D502 
91AA5883 
0003FFCB 
D2039345 
D2119144 
924648B3 
07749533 
58609043 
91C05353 
58B091C3 



EEEE31B4 
87878737 
00000007 
000O02DO 
EEEE0196 
EEEE31B4 
87878787 
00000007 
000002:8 
EEEE0196 
EEEE0156 
EEEE310C 
FFOOF640 
OOOOOOOE 
8310C2C7 
EEEE01C8 
00000038 
00003000 

ooo;',3000 

8310C2C7 
EEEE01C8 
00000008 
00003300 
00000000 



040C2000 
80808080 
00008B60 
00040000 
470D0000 
040C2000 
80808080 
00008B60 
00040000 
47000000 
070F2000 
040C0000 
OOOOOOOE 
OO0OF7B8 
80006690 
470DOOO0 
000164EO 
83008863 
00000007 
80006690 
47000000 
00016500 
80008860 
00000000 



000009BC 
80838080 
00000018 
00003AB4 
00008AB6 
000009BC 
80838080 
00000017 
00303AB4 
000084C0 
00000962 
0000168E 
00003FF0 
08003000 
71006700 
00003AB6 
0000370A 
40008944 
D0008B60 
71006700 
30008AB6 
30008704 
90008944 
00000000 



00001010 
80838080 
00008848 
003004AO 
00081010 
00001010 
80808080 
00008848 
000004AO 
00081010 
00001010 
00031010 
080060C6 
OOO0F7A8 
200E2880 
00081010 
00000030 
OO0087C0 
00000016 
200E2880 
0038 1010 
00030030 
000087C3 
0000 0000 



00 00000000 00000000 00000000 



0000168E OO0OB44E 00000C56 
J]>7;*C1C9 C403E3E6 FFFF3309 

/) . " / sf/f 1 ni 



020F8003 
B03391CC 
91:05380 
0303FFEO 
9049D233 
923495FF 
91D29156 
939FV773 
D2039054 
91C45373 
92FFB330 



00 3892FF 
078A0531 
91C49878 
C4E4D4D5 
934B9044 
903A4770 
906C0000 
92540231 
90401B65 
91C89857 
D213B001 



eo7 

)78 

u (OAH700 

801392FF 
B00691CF 
91B807FA 
E710300E 
320093B1 
921C3201 
00003015 
90989296 
18761B66 
910447F0 
B00047F0 



00009F02 
FFFFFFF= 
0003FFF5 
44039186 
B0454770 
078495FF 
9001 800B 
41110000 
8008 0040 
91B80201 
91564700 
801458B0 
07845883 
OOO0O000 
OO00OC56 
90430200 
913E922A 
47809156 
90579134 
5D609230 
9244AO00 
906:0000 



00000000 00003303 00300000 00330000 00000000 00000000 



HEX LENGTH IS 0000 

37:8:1=2 C55C5C5C 07102000 000403CE 

07C8:lE2 B004009E 00040620 00000000 

7F0B394E 80000015 OOO88FFF 900421F6 

00000000 00000000 00000000 00000000 

58103535 58F1OO10 45EF0O0C 024FB13E 

B58A5330 B58EOA12 5810BS92 5C00B59S 



00003030 00000000 40343074 00040078 

0002FOOO 00088FFF 00000000 00000000 

30308450 5706A7E4 00003000 00030000 

00003000 00030000 05S0024F B18EB4AE 

B4FE5313 B58658F1 301345EF 000:5813 

0A3A1B99 12334780 B0460630 47F0B03A 






,#..D.... 
. . .DUMNX. 



*...-. K 

Hit..** .D#..H...M.O. 

, #.M K 0. 



PHASE*** 
PHAS. ... 



.6 ...*... I). 



■ 0«. (2'4 



The example above shows part of a system dump output. By examination of the 
PDAREA printed in the dump (when PDAID is supported by the system) it can 
be seen that a QTAM trace was active when the dump was executed. From the 
PDAID phase name in the PD area, the output mode for the trace was core-wrap. 
However, no trace entries are seen in the PD area, whtch indicates that the an 
alternate area had been specified for the trace entries. The start address of the 
alternate area is contained at displacement decimal 20 from the start of the PD 
standard preface table. (The standard preface table starts at the PDAID 
phase name.) 
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Trace Routines 

PDAIDS 



016BC0 
OlSBEO 
015COO 
016FE0 

-P.O.- 
009480 
0394A0 
0094CO 
00946 
009500 
009520 
009540 
009560 
009580 
009 5A0 
009 5C0 
009 5E0 
009600 
009620 
009640 
009660 
009680 
OO96A0 
0096CO 
0096EO 
009700 
009720 
009740 
009760 
009780 
C097A0 
009 7C0 
0097EO 
C09800 
009 820 
009840 
009 860 
009880 
009 8A0 
OO98C0 
C098E0 
009900 
009920 
009940 
009960 
009980 
0099AO 
C099CO 
009 9E0 

LBLTYP 

-_F 2— 

SI 000 



10/05/73 

000005A8 OOOB1000 00003AE4 00004360 
0OOB237A D7C8C1E2 800B136C 000B32A8 
00000000 —SAME — 
00000000 OOOOOOOO 00000000 00000000 



& 






AREA 

00003000 
FFFFFFFF 
FFFFFF30 
078A4400 
90BC42:il 
9101073*. 
5870001' 
402 09132 
92FF8D10 
91D2033A 
91765880 
008053BO 
91C441B8 
00006360 
OF2033DO 
OOFFFFFF 
2 0000030 
008B6DC6 
F8C80000 
0000FFFF 
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This example shows part of a system dump output that by examination of the PD 
area indicates QTAM trace entries in the PD area. Compare this example with the 
previous one and note the difference between the information contained in the 
PD area. 



Serviceability Aids. 2.55 



Trace Routines 

PDAIDS 



The PD area 

The PD area is located in the supervisor and consists of four separate parts 
described below and shown in 

1. PD Address Table 

This table is built up during system generation if the system is to support 
PDAIDS. It contains the addresses of the supervisor hooks that provide the 
interface between the PDAID routines and the supervisor. 

2. PD Standard Preface Table 

This table is built up by the PDAID initializing phase, and is used by the PDAID 
event handling routines. 

3. PDAID Event Handling Area 

This area is occupied by the PDAID event handling routines specified by the 
type of trace requested by the operator. 

4. PD Buffer Area. 

This area is used in the following two ways: 

When core-wrap output mode in the PD area is specified it is used as a rotating 
buffer which preserves events (trace entries). PDAID event handling routines 
use this area as temporary storage for events. This storage area is called the 
trace table. Data is transferred from this table to an output area, which is either 
printed out or dumped on a tape unit, depending on the output device selected 
for the trace routine. 



Locating the PD area 

The start address of the PD area can be located by: 

1. Using any dump containing the supervisor area to find the address of SYSCOM 
(system communication region) in bytes 80 to 83 of low address storage. (See 
E-2 in this Section.) 

The address contained in bytes X'48' to '4B' (label PDARPTR) of SYSCOM 
contains the address of the PD area. 

2. Using the supervisor listings to find the address of the label PDAREA. This 
label is the name given to the first byte of the PD area. 

Dumping the PD area 

The easiest method is to use the PD AREA operand of the DUMP command. (See 
A-l in this Section.) Alternatively, any dump of real storage that includes the 
supervisor area will also include the PD area. 
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/ 



Virtual Storage 

/ \ 
/ \ 



\ 



\ 



LOW ADDRESS STORAGE 



SUPERVISOR 



PD AREA 



Label 








PD AREA 






PD Address Table 




PD Standard 




Preface Table 




PD Event 




Handling 




Routine area 




A 


B 


C 




PD Buffer. 




Used for core-wrap 




output, or PDAID 






event handling. 



For details of 
contents, see 
Appendix A. 



1 



/ 



/' 



/ 



/ 



/ 



PD buffer, when 
used as core-wrap 
/ I output mode. 

/ 
/ 



/ 



BACKGROUND 
PARTITION ( 



Note: 

See Section 4 for details about the supervisor organization. 



FIRST entry, 



NEXT entry, 



LAST entry, 



Trace type. 



Input/output 



Fetch/load 



GSVC 



QTAM 



Address of FIRST 
entry, (SLOT1) is 
found at location 



PDAREA + X"I98' 



PDAREA + F4 



PDAREA + X'114' 



PDAREA + '1C(Z>' 



B 



Address of NEXT 
entry is found at 
location; 
(See Note T.) 



B = A + 4 



B = A+4 



B = A + 4 



B = A + 4 



Address of LAST 
entry, (WRAPADR) 
is found at location; 
(See also note 2.) 



C = A + 8 



C = A + 8 



C = A + 8 



C = A + 8 



Length of one 
entry in bytes; 



18 (dec) 



22 (dec) 



18 (dec) 



21 (dec) 




Maximum number 
of entries in the 

minimum PD area 
of 1200 bytes (dec) 



42 



42 



50 



35 



Notes: 

1. For the I/O trace 

NEXT — address of the next available slot in the save area. (Because NEXT 
is filled with unchecked new information, it may contain either the oldest 
entry in the table, or the most recent activity of a device not being traced. 
If the latter is the case, ignore the entry.) 

For the F/L, GSVC, and QTAM trace 

NEXT — address of the next available slot in the save area. (Because NEXT 
is filled with unchecked new information, it may contain either the oldest 
entry in the table, or the SVC number and calling address from a partition 
not being traced. If the latter is the case, ignore the entry.) 

2. When LAST entry is filled, next becomes first and the buffer is overwritten by 
new entries. 

Table B-3 Trace entry locations and lengths for core-wrap output mode in the PD area. 
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Initiating the PDAID trace routines 

You can initiate PDAID trace routines by using standard DOS/VS job control 
languages from either SYSLOG or SYSIPT. The statement 

//EXEC PDAID 

causes the main phase (PDAID) to be loaded at the address of the initiating 
partition. Control is given to the PDAID for further specifications to indicate 
the type of trace to be performed. 

The options and control statements for the trace routines may be entered through 
SYSLOG or through the device assigned to SYSIPT. 

If a card reader is used as SYSIPT, the card deck must be punched as follows: 

Entries may be punched one-per-card, or as multiple entries (separated by commas) 
in a single card. An entry may not be split between two cards. All 80 columns of a 
card may be used, but a card is terminated either by the first blank following an 
entry, or by a GO entry. The last card must be followed by a /* CARD. 

Note: If an incorrect parameter is read from SYSIPT, corrections are requested on 
SYSLOG. 

When the initializing phase (PDAID) has been loaded, the following message is 
issued on SYSLOG: 

4C10DPDAID= 

The operator must respond to this message with one of the following: 

IT Specifies an I/O Trace (See note 1 .) 

FT Specifies an F/L Trace (See note 1.) 

GT Specifies a GSVC Trace (See note 1 .) 

QT Specifies a QTAM Trace (See note 1 .) 

TD Specifies the Transient Dump 

(refer to A-4 in this Section) 

XX Terminates the PDAID presently running 

Pressing the END or ENTER key indicates that PDAID control statements are 
entered through SYSIPT (See note 2.) 

Notes: 

1. When IT, FT, GT, or QT is specified, the operator must provide additional 
PDAID control statements through SYSLOG. 

2. The END response is valid only for SYSLOG and cannot be used as a SYSIPT 
operand. 

3. Multiple operands or operator responses to PDAID control statements for traces 
with a variable number of functions (such as ignoring SVCs) are not allowed. 
Repeat each parameter with each variable). Repeat each message until either 
the maximum number of variables is reached or an END response is given. 

4. GO terminates the PDAID control input, and the default is taken for any 
PDAID options that are not specified. When you use SYSIPT, GO should be 
the last parameter, and it has no operand associated with it. A /* card must 
follow the GO operand. 
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Selection of an output device: 

The PDAID message/parameter OUTPUT DEVICE= permits the selection of an 
output device. Specify the device by channel and unit, not by symbolic unit. If an 
output device is specified, PDAID checks the address against the supervisor PUB 
and selects the appropriate phase for the unit type (tape or printer). If the output 
is to be magnetic tape, you must use the PDLIST program after tracing is 
complete to obtain a printout of the tape. 

Selection of core-wrap mode: If an output device is not specified, core-wrap mode 
is assumed. The event trace table (see Table B-3) is in the PD buffer in PD area. 
The number of events (trace entries), contained in this area depends on its size as 
generated at system generation time with the option of the FOPT macro. PD=YES 
or 1400 is the minimum, and 10,240 is the maximum that can be selected. 

The table shown in the previous illustration lists the maximum number of events 
that can be preserved in this area, for each of the four trace routines. If core-wrap 
mode is selected, an alternate area can be used. 
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Specifying an Alternate Area 

An alternate area may be specified for core-wrap output through the message/ 
parameter AAA= (alternate area address). AAA= and OUTPUT DEVICE= are 
mutually exclusive: when one is specified, the other cannot be used. The 
operator specifies an alternate area by responding to AAA= with nk. 

n should be an even integer but if an odd integer is specified, n+1 is assumed, 
n specifies the number of thousand (1024) bytes to be allocated to the alternate 
area, which is taken from the main page pool. 

After AAA=nk has been entered, one of four messages is printed on SYSLOG: 

1. If the requested size of the alternate area is accepted, the message is 
4C50E ADDRESS OF AAA= xxxxxx 

2. If space could not be allocated from the main page pool, the message is 

4C52E NO SPACE AVAILABLE FOR AAA.PDAID IS TERMINATED 

The size of the page pool must be increased and the PDAID must be 
re-initialized. 

3. If the space requested is larger than the space that can be allocated from the 
page pool, the message is 

4C51D SIZE OF AAA-nK, ADDRESS OF AAA=XXXXXX. END/CANCEL 

If the space allocated is sufficient, the operator need only press the END/ENTER key. 
However, if the space allocated is not sufficient, the operator must respond 
with CANCEL, and the size of the page pool must be increased before 
re-initializing the PDAID. 

4. If a second or duplicate request is made for an alternate area, or if a request is 
made for a PDAID using an alternate area while any SDAID function is running, 
the second request is automatically terminated, and the message is 4C70E 
4C70E DUPLICATE REQUEST FOR PDAID AND/OR SDAID 

The above message is also issued if a second or duplicate request is made for SDAIDS. 

Dumping the alternate area 

The contents of the alternate area is automatically dumped on the device assigned 
to SYSLST upon termination of the PDAID. (See "Terminating core-wrap in an 
alternate area" for details.) However, if a dump of an alternate area is required 
without terminating the PDAID, use the xxxxxx, xxxxxx operand of the DUMP 
command. (See A-l in this Section for details.) 

Note: If this command is used, the trace output will include the fetch and execute 
of the DUMP transient. Specify the address of AAA in the first operand of the 
command, and calculate the value of the second operand from the value ofnk, 
given in the message 4C51D or specified in the message 4C27D during trace 
initialization. 

Use Table B-3 and the dump to locate the oldest and newest trace entries. 
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PDAID routines issue error messages on SYSLOG if incorrect or duplicate 
parameters are specified, or if selected output devices are not ready. The PDAID error 
messages together with recommended actions for operators and programmers are 
listed in the DOS/VS Messages manual. 

The following list is a table of options and control statements for executing the 
trace routines. The statements in the table are shown in the sequence in which 
they must be used. Five flowcharts follow the table of options. These flowcharts 
show how to execute the trace routines. 

Six examples of initiating trace routines via SYSIPT, followed by five examples 
of initiating via SYSLOG, immediately follow the last of those flowcharts. 
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SYS LOG 

Message 



SYSIPT 
Parameter 



SYS LOG 
Response 



SYSIPT 
Operand 



Meaning 



Default 



PDAID = 



FT 
GT 
, IT 
1 QT 
TD 

XX 

END 



FT - Fetch/Load Trace 
GT - GSVC Trace 
IT- I/O Trace 
QT - QTAM Trace 

TD — Transient Dump, refer to A-4 in this Section 
XX - Terminate present PDAID function. 
END - Additional PDAID control input through 
SYSIPT (See note 5) 



None. 



OUTPUT DEVICE 
(see note 3) 




Specify the hexadecimal channel and unit number 
of either a magnetic tape unit or a printer for the 
output device of the PDAID. 
(see note 6) 



Core-wrap mode. 
(See note 7) 



AAA = 
(see note 3) 




The parameter nK specifies the number of bytes to 
be allocated as alternate address area. This area will 
be allocated storage from the main page pool. The 
value n must be an even integer. If it is not an even 
integer, (n+1 ) K is allocated. 



Core-wrap 
mode using 
PD area 



TRACE PARTITION 
(Valid for Fetch/Load, 
SVC, and QTAM Trace) 



SP 

BG 

F4 

F3 

F2 

F1 

END 

GO 



SP - Supervisor 
BG -Background 
F4 - Foreground 4 
F3- Foreground 3 
F2 - Foreground 2 
F1 - Foreground 1 
(see note) 



Trace all partitions and 
the supervisor, 



IGNORE DEVICE = 
{See notes 2 and 7) 



cuu 
X'cuu' 
END 
GO 



Specify the hexadecimal channel and unit number 
of the device to be ignored by the I/O and QTAM 
trace. A maximum of 3 may be specified. 



Trace all devices. 



J.A 



TRACE DEVICE= 
(See notes 2 and 7) 




Specify the hexadecimal channel and unit number 
of the device to be traced by the I/O and QTAM 
trace. A maximum of 3 may be specified. 



Trace all devices. 



IGNORE SVC= 
(See notes 2 and 7) 




Specify the hexadecimal SVC number to be ignored 
by the GSVC trace. A maximum of 6 may be 
specified. 



Trace all SVCs. 



TRACE SVC = 
(See notes 2 and 7) 




Specify the hexadecimal SVC number to be traced 
by the GSVC trace. A maximum of 6 may be 
specified. 



Trace all SVCs. 



GO (Valid SYSIPT 
Parameter) 
(See note 4) 



GO 
(Valid SYSLOG 
Response) 
(See note 4) 



GO terminates the PDAID control input and the 
default is used for those options that are not 
specified. 



None. 



Notes: 1. Specification of F1 or F2 is valid for MPS supervisor only. Only SVCs and 31 are recorded for the QTAM trace. 

2. The trace and ignore options are mutually exclusive. 

3. The output device and AAA options are mutually exclusive. 

4. GO will generate default parameters. 

5. END means 'Press the END key', or for Models 1 15, 125, and 158 press the ENTER key. 

6. A magnetic tape unit is the only valid output device for the QTAM trace. 

7. Not applicable to the Transient dump. 

Table B-4 Options and control statements for executing the PDAID trace routines. 

Six examples of initiating trace routines via SYSIPT, followed by five examples of initiating via SYSLOG, immediately follow 
the last of those flowcharts. 
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Operator's 
flowcharts 



//JOB PDTRACE 
//EXECPDAID 



4C10DPDAID= 



Enter XX 
and press 
END key 



Select a 

trace 

function 



Press 
END 
only 



Trace events 
specified by 
the function. 



Terminate present, 
trace routine. 



Read parameters 
from SYSIPT. 



Begin selected trace 



4C11D OUTPUT DEVICE= 



Enter GO 
and press 
END key 



Press END 
key 



Specify an 
output device 
X'cuu' 



4C27D AAA= 



Enter GO 
and press 
END key. 



Specify a 
value for 
alternate area 



Press 
END 
only 



One of four 
messages is issued 



Assume core 
wrap output 
mode with 
default parameters 



Log trace in 
specified alternate 
area 




To part 2, 3, 
4 and 5 



To part 2 To part 3 To part 4 To part 5 



PDAIDS 
Initializing PDAIDS part 1 of 5 



IT - I/O Trace 

FT- Fetch/Load Trace 

GT- GSVC Trace 

QT- QTAM Trace 

TD - Transient Dump (A-4-F) 




Specify the hexadecimal channel 
and unit number of either a 
magnetic tape unit or a printer 
for the output device of the 
PDAID. 

Note: A magnetic tape unit is the 
only valid output device for the 
QTAM trace. 



Specify the number of bytes 
allocated to an alternate area. The 
value must be an even integer, 
otherwise the next higher even 
integer is used. 

For a description of these 
messages and required operator 
responses, see 
Specifying an Alternate Area. 

For an I/O, F/L, or GSVC trace 
the device is a line printer or 
magnetic tape unit. For a QTAM 
trace the device may only be a 
magnetic tape unit. 



B-4-F 
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Initializing PDAIDS part 2 of 5 



From part 1 



From part 1 




4C13D IGNORE DEVICE = 



Specify the hexadecimal channel and 
unit number of the device to be 
ignored (X'CUIT) and press END key. 
A maximum of 3 may be specified. 



Note 

The trace and ignore options are 

mutually exclusive. 

Specify the hexadecimal channel and 
unit number of the device to be 
traced (X'CUU') and press END key. 
A maximum of 3 may be specified. 



Select 

device(s) 

to be ignored 



Press 
END 
key 



Enter 
GO 



4C14D TRACE DEVICE = 



Select 
device (s) 
to be traced 



Ignore these 
devices 
(Maximum of 3) 



Press 
END 
only 



Enter GO 
and press 
END 



Trace only 
these devices 
(Maximum of 3) 



Assume that all 
devices are to 
be traced 



Begin trace routine 



Store I/O events 
in the PD area or 
an alternate area 



Display I/O events, 
by 'dumping' 




//EXECPDAID 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu' 

// MTC REW.SYS005 

// EXEC PDLIST 

/* 

/& 



Display I/O events 
using this utility 
program 



Display I/O events 
as they occur 
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Initializing PDAIDS part 3 of 5 



From part 1 



From part 1 



4C12D TRACE PARTITION = 



Enter GO 
and press 
END key 



Assume that all 

partitions 

are to be traced 



Press 
END 
only 




SP - Supervisor 
BG- Background 
F4 - Foreground 4 
F3 - Foreground 3 
F2 - Foreground 2 
F1 - Foreground 1 



Trace specified 
partitions 




Begin trace routine 



Display F/L events 
as they occur 




Store F/L events 
in the PD area or 
an alternate area 



//EXECPDAID 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu' 

// MTC REW,SYS005 

//EXECPDLIST 

/* 

/& 



Display F/L events 
using this utility^ 
progra m 



Display F/L events 
by 'dumping' 
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Initializing PDAIDS part 4 of 5 



From part 1 



From part 1 



SP - Supervisor 
BG- Background 
F4 - Foreground 4 
F3 - Foreground 3 
F2 - Foreground 2 
F1 - Foreground 1 




4C12D TRACE PARTITION = 



SPECIFY 
partition 
to be traced 



Enter Go 
and press 
END key 



4C16D TRACE SVC = 



Specify the hexadecimal SVC number 
to be traced by the GSVC trace. A 
maximum of 6 may be specified. 



Assume all 
partitions to be 
traced 



SVC(s) 
to be 
traced 



Press 
END 
only 



Enter Go 
and press 
END key 



Specify the hexadecimal SVC number 
to be ignored by the GSVC trace. A 
maximum of 6 may be specified. 



4C15D IGNORE SVC = 



Specify 
SVC(s) 
to be ignored 



Press 
END 
only 



Enter Go 
and press 
END key 



Trace these SVCs 
(Maximum of 6) 



Ignore only 
these SVCs 
(Maximum of 6) 



X 



Store SVC events 
in the PD area or 
an alternate area 




Assume that all 
SVCs are to be 
traced 



//EXECPDAID 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu' 

//MTCREW.SYS005 

// EXEC PDLIST 

/* 

/& 



Display SVC events 
by 'dumping' 



Display SVC events 
using this utility 
program 



Display SVC events 
as they occur 
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from part 1 



from part 1 



A 



PDAIDS 
Initializing PDAIDS part 5 of 5 



4C13D IGNORE DEVICE = 



Select 

device (s) 

to be ignored 



Press 
END 
only 



Enter GO 
and press 
END key 



4C14D TRACE DEVICE = 



Press 
END 
only 



Select 
device to 
be traced 



Enter GO 
and press 
END key 



Ignore 
these 

devices (Max. 
of 3) 



Assume all 
devices to be 
traced 



Trace only these 

devices 

(Max of 3) 



i=r 



4C12D TRACE PARTITION : 



Press 
END 
only 



I 



Enter GO 
and press 
END key 



or 



Specify 
Partition 
to be traced 



Assume all 
partitions to 
be traced 




Specify the hexadecimal channel and 
unit number of the device to be 
ignored X'CUU' and press END key 
A maximum of 3 may be specified. 

Note: 

The trace and ignored options are 

mutually exclusive. 

Specify the hexadecimal channel and 
unit number of the device to be 
traced X'CUU' and press END key. 
A maximum of 3 may be specified. 




SP Supervisor 
BG Background 
F4 Foreground 4 
F3 Foreground 3 
F2 Foreground 2 
F1 Foreground 1 



Assume all 
devices and all 
partitions to 
be traced 



J 



Commence trace 
routine 



//EXECPDAID 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu' 

//"MTCREW,SYS005 

//EXECPDLIST 

/* 

/& 



I 



Display QTAM 
events using this 
utility program 



Store QTAM 
events in 
PD area or an 
alternate area 
I 



Display QTAM 
events by 'dumping' 
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The following six examples show job streams to initiate trace routines through 
SYSIPT. 

Examples 1 — I/O Trace Function (single entry per card): 



//JOBCARDINP1 

//EXECPDAID 

PDAID=IT 

AAA=2K 

IGNORE DEVICE=190 

IGNORE DEVICE=191 

GO 

/* 

/& 



Calls for initializer. 
Calls for I/O trace function. 
Specifies alternate save area. 
Ignores events from 190. 
Ignores events from 191. 
Signals end of input. 



Note: No output device is specified; therefore, core-wrap is selected by default. To 
obtain the data held in the alternate area, SYSLST must be assigned to either a 
line printer, tape unit, or disk drive. Exercise care, therefore, during termination 
ofPDAID. 

For example: 

//ASSGN SYSLST, X"I91' 
//EXECPDAID 

ensures that the alternate area is dumped on device 191 before responding XX to 
the message 4C10D PDAID=. 

Example 2 — I/O Trace Function (multiple entries): 



//JOBCARDINP2 

//EXECPDAID 

PDAID=IT, IGNORE DEVICE=00E, 

OUTPUT DEVICE=180, 

GO 



/* 

//EXEC ASSEMBLY 

Source 

Deck 

/* 

//EXECPDAID 

PDAID=XX, 

/" 

// ASSGN SYS005,X"1 80' 

// MTC REW,SYS005 
// EXEC PD LIST 
/* 

/& 



Calls for initializer. 



Calls for I/O trace function. Specifies that 
the function ignore interrupts from 00E and 
record I/O events on 180. (Assume 180 is a 
tape unit) Signals end of input. 

I/O activity of assembler will be traced; 
output will be on tape drive 180. 



Terminates I/O trace function. 



Assigns tape to SYS005. 

Rewind the tape. 

Print out contents of tape on the printer 

using the PDLIST program. 

program. 



Tape is formatted and listed on SYSLST. 
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//J0BCARDINP3 

//EXECPDAID 

PDAID=FT 

TRACE PARTITI0N=F2 

TRACE PARTITION=BG 

GO 

/* 

/& 



Calls for initializer. 
Calls for F/L trace function. 
Trace foreground 2 partition. 
Trace background partition. 
Signals end of input. 



Note: Because no output device (OUTPUT DEVICE=) is specified, core-wrap is 
selected by default. 



Example 4 — Fetch/Load trace Function: 



//JOBCARDINP4 

//EXECPDAID 

PDAID=FT 

OUTPUT DEVICE=OOE 

GO 

/* 

/& 



Calls for initializer. 
Calls for F/L trace function. 
Specifies printer output. 
Signals end of input. 



Note: All partitions are traced if this is a multiprogramming system. 



Example 5 — GSVC Trace Function: 

//JOBCARDINP5 

//EXECPDAID 

PDAID=GT 

OUTPUT DEVICE=00E 

TRACE PARTITION=BG 

TRACE PARTITION=F2 

TRACE SVC=01 

TRACE SVC=04 

GO 

/• 

/& 

Example 6 — QTAM Trace Function: 

//JOBCARDINP6 

//EXECPDAID 

OUTPUT DEVICE=180 

TRACE DEVICE=183 

TRACE DEVICE=OOE 

GO 

/• 

/& 



Calls for initializer. 
Calls for GSVC trace function. 
Specifies printer output. 
Trace background partition. 
Trace foreground 2 partition. 
Trace SVC 1. 
Trace SVC 4. 
Signals end of input. 




Calls for initializer. 
Specifies tape output. 
Trace events on tape drive 183. 
Trace events on printer. 
Signals end of input. 



Note: All partitions are traced if this is a multiprogramming system. 
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SYSLOG, 

Example 1 — Store all I/O events in core using PD area for tables'. 

//JOBTYPINPT1 

// EXEC PDAI D Calls for initializer. 

4C10D PDAI D= Console requests function. 

IT and press END Operator response: I/O trace function. 

OUTPUT DEVICE= Console requests output device. 

GO Operator response: end of input (PD area 

is used for output). 

Note: Because no output device is specified, core-wrap mode is selected by default. 
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//JOBTYPINPT2 
//EXECPDAID 
4C10DPDAID= 
IT and Press END 
OUTPUT DEVICE= 
00E and press END 
IGNORE DEVICE^ 
Press END 
TRACE DEVICE= 

180 and press END 
TRACE DEVICE= 
090 and press END 
TRACE DEVICE= 
01 F and press END 

Note: GO does not have to be specified here. The initializer knows this is the end 
of input because three TRACE entries have been made. 

Example 3 — Trace only the background partition and store the F/L events in the 
PD area: 



Calls for initializer. 
Console requests function. 
Operator response: I/O trace function. 
Console requests output device address. 
Operator response: printer output. 
Console requests IGNORE parameters. 
Operator response: no devices to be ignored. 
Console requests devices to be traced and 
the operator specifies them. 



//JOBTYPINPY3 

//EXECPDAID 

4C10DPDAID= 

FT and press END 

OUTPUT DEVICE= 

END 

AAA= 

Press END 

TRACE PARTITION^ 
BG and press END 
TRACE PARTITION^ 
GO and press END 



Calls for initializer. 

Console requests function. 

Operator response: F/L trace function. 

Console requests output device. 

Operator response: core-wrap mode. 

Console requests alternate area. 

Operator response: no AAA; store events in 

PD area. 

Console requests partition to be traced. 

Operator response: background. 

Console requests second partition. 

Operator response: end of input. 
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Example 4 
on printer. 



Trace all SVC's in both foreground partitions and list events 



// JOB TYPINPT4 

//EXECPDAID 

PDAID= 

GT and press END 

OUTPUT DEVICE= 
00E and press END 
TRACE PARTITION 
F1 and press END 
TRACE PARTITION= 
F2and press END 
TRACE PARTITION= 
Press END 

IGNORE= 
Press END 
TRACE SVC= 
GO and press END 



Calls for initializer 

Console requests function 

Operator response. Generalized SVC trace 

function 

Console requests output device 

Operator response: Printer output 

Console requests partition to be traced 

Operator response: foreground 1 

Console requests second partition to be traced 

Operator response: foreground 2 

Console requests third partition to be traced 

Operator response: no more partitions 

to be traced 

Console requests first SVC to be ignored 

Operator response: No SVCs to be ignored 

Console requests first SVC to be traced 

Operator response: Trace all SVCs: end of input 
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//JOBTYPINPT5 
//EXECPDAID 
4C10DPDAID= 
QT and press END 
OUTPUT DEVICE= 
Press END 
AAA= 
Press END 
IGNORE DEVICE= 
Press END 
TRACE DEVICE= 
180 and press END 

TRACE DEVICE= 
OOE and press END 

TRACE DEVICE= 
Press END 

TRACE PARTITION 
F4 and press END 
TRACE PARTITION^ 

Press END 



Calls for initializer. 
Console requests function. 
Operator response: QTAM trace. 
Console requests output device address. 
Operator response: PD area. 
Console requests alternate area. 
Operator response: no alternate area. 
Console requests device to be ignored. 
Operator response: no device to be ignored. 
Console requests device to be traced. 
Operator response: Trace interrupts on 
device 180. 

Console request second device to be traced. 

Operator response: trace interrupts on device 

OOE. 

Console requests third device to be traced. 

Operator response: no third device; end of 

input. 

Console requests first partition to be traced. 

Operator response foreground 4. 

Console requests second partition to be 

traced. 

Operator response: end of input. 
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PART 2 SDAIDS 



General description 

SDAIDS provide further tracing facilities to supplement those already provided by 
the PDAIDS. While the PDAIDS produce a predefined output for each type of 
trace, as described in Part 1 of this Section, most of the SDAID trace functions can 
be initiated to produce information that is more defined for a given type of system 
malfunction. The SDAID printout ranges from one printed line for each event up to 
a dump of the complete real storage for each event. (No events will be lost as 
they may be with PDAID output.) SDAIDS also provide special dumping 
facilities that enable non-destroying dumps to be executed on the occurrence of 
specific events during program operation. 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for example, a program using MICR or teleprocessing as input/ 
output, must be considered before using this serviceability aid. 



The SDAID trace functions are as follows: 

1. A page trace, consisting of 

• a page translation exception trace (when a page fault occurs) 

• a page enque trace (when a page is placed in the page queue) 

• a page handling trace (when a page is removed from the page queue) 

2. An instruction trace that records instructions in the order in which they are 
executed between any selected addresses. 

3. A main storage alter trace that records the address of the instruction that 
altered the contents of any or all byte locations between any selected 
addresses. 

4. A general register alter trace that records any alteration made to any one, or 
any selected, general registers. 

5. A successful branch trace that records the address at which a successful branch 
is made, be j tween-any~seleeted==ad4=resse& 



The stop and dump facilities are: 

1 . Stop on event: On the occurence of one or any of the following specified 
events, all system activity is suspended after SDAID output is complete. 

• at any specified instruction address 

• on alteration of any byte location between any selected addresses 
on alteration of one or more specified general registers 
on any successful branch that occurs between any selected addresses 
on the occurrence of a page translation exeption 
on the occurrence of a program check code X'OT— X'10' and X'12' 
on the occurrence of a request for a page to be placed in the PG queue 
(page fault enqueued). 

on the occurrence of a request for a page to be removed from the PG 
queue by the page handler. 
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2. As well as being able to obtain a dump of areas specified by the output class at SD A I DS 

the stop event, it is possible to obtain a dump of real and virtual address areas 
after the specified output class has been dumped. 

The types of dumps that can be obtained in this way are: 

• Non-destroying dump: This is a dump of all real storage. It can be obtained if 
required after a stop on event. The dump is non-destroying because system 
status information is preserved, thus enabling system operation to continue 
after execution of the dump. 

• Dump on a program check: On the occurrence of a program check interrupt 
(codes X'01' to X'0F\ X'10', and X'12'), a non-destroying dump of the 
complete supervisor area is automatically executed. 

• PDUMP: Enables a dump of a minimum area of 32 bytes (one print line) 
between two virtual address limits. The maximum area that can be dumped 
depends only on the size of virtual storage, and only virtual address 

area information that is in real storage is dumped. 

System requirements 

The SD area need not be specified during system generation, but the SDAID initial- 
izing and terminating programs must be cataloged in the core image library. 

SDAIDS make use of program event recording and monitoring, described in 
Appendix E. 

Output from all SDAIDS routines is directed to a line printer. The line printer is 
non-dedicated, meaning that the same printer may be used as an output device for 
other programs as well as for the SDAIDS. Therefore, SDAID output may be 
interspersed with job output. 

Note: the following restriction, if the printer is connected via a selector or block 
multiplexer mode channel: 

No other devices must be running on the same channel as the printer at the moment 
when SDAID attempts to write to the printer. 
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SDAID Characteristics 

• SDAIDS reside in the SD area, which must occupy at least 6K bytes of the 
real address area. 

The storage assigned to the SD area is taken from the page pool. 

• SDAID is initialized by // EXEC SDAID, and requires 12K of a real or virtual 
partition (only during initialization of any SDAID function). Parameters, 
specified either at initialization time or later, must be entered on the console. 



• After initialization, SDAID does not use DOS/VS services. 

• SDAID has immediate control in case of a program check interruption. 

• SDAID runs with DAT (Dynamic Address Translation) off, disabled for I/O and 
external interrupts. 

• After SDAID handled event, processing continues as if event handling had not 
occurred. 

• Only the contents of the real address area is dumped with SDAID. (Pages that 
currently reside only on the page data set will not be dumped.) 

• SDAID may not be used to debug time-dependent programs because it runs 
disabled while recording events and thus delays processing. 

• Because SDAIDS use the program event recording PER facility, and because 
time is required to print SDAID output, program execution time is increased. 
Its effect on the operation of time-dependent programs must therefore be 
considered before using this serviceability aid. Performance degradation when 
using SDAIDS will be reduced when the FASTREC output class is selected. 

• Debugging of printer error recovery routines is possible only if the FASTREC 
output class is used. 

• If, during the printing of SDAID output, the line printer is stopped for any 
reason or becomes not ready, the system will enter a wait state with a message 
in low address storage. To continue printer operation, press the EXTERNAL 
INTERRUPT key. 

• When initialization is complete, the event handling routines within the SDAID 
initiating program partition are transferred to the SD area. The 12K partition 
can then be re-used, but the pages occupied at the end of the page pool by the 
SD area are not released for normal program use until all SDAID functions are 
terminated. 
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Terminating the SDAID routines 

The tool SDAID is terminated, and the SD area is released to the page pool by 
one of the following: 

1 . The AR (attention routine) command ENDSD 

2. The job control statement // EXEC ENDSD 

Note: Depending on the events being traced and the event limits specified, it may 
take some time before the attention routine or job control becomes active. One 
method to avoid this delay is to clear control register 9 using the ALTER/DISPLA Y 
console feature before requesting the attention routine. 
This de-activates all PER event tracing. 
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Using SDAID and PDAID concurrently 

If the system has been generated to accept PDAIDS, any one of the PDAID trace 
routines may run concurrently with SDAID. However, if the PDAID currently 
running is using an alternate area, it must first be terminated before an SDAID 
routine can run. 



SDAID Events 

SDAID events are recognized as program checks. There are two groups of events: 
elementary events and dedicated events. 

Elementary events are: 



Mnemonic 


Event 


BR 

IF 

SA 

GA 

TE 


successful branching 
instruction fetching 
storage alteration 
general register alteration 
page translation exception 



Dedicated events are : 



Mnemonic 


Event 


PGMCHK 

PAGENQ 
PAGEHDL 


program interruption codes 
X'OV-X'OF' and X"IO', X"12' 
request for page is enqueued 
request for page is handled 
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SDAID output information 

When an event occurs, the SDAID event handling routines will record either the 
information specified by output class parameter (for elementary events), or 
predefined data (for dedicated events). 

By using the output class parameter of the SDAID operand OUTCL= the amount and 
and type of information required for offline program debugging can be selected for 
the elementary event during initialization of the SDAIDS. After initialization, the 
output class can also be re-specified if required. 

For elementary events the output class can be specified according to Table B-6-A. 
However, if more than one elementary eve nt is being traced simultaneously, the 
output class will be the same for all events. For each dedicated event, a predefined 
output is obtained as shown in Table B-6-B. 

Output if more than one event is being traced: 

Events can be enabled individually or in combination with one another. If some or 
all of the events BR, IF, SA, and GA happen concurrently, the output class listed 
in Table B-2-A is printed only once. The event ID, however, contains the mnemonics 
of all current events. 

If any of the other events happen concurrently, even if they occur together with 
one of the events BR, IF, SA, or GA, the output is printed for each event that 
occurs. 

PDUMP output class: A PDUMP is triggered by events just as the other output 
classes. It dumps a minimum of 32 Bytes (one print line) between two virtual 
address limits. The maximum area that can be dumped depends only on the size of 
virtual storage. Any are a between the two limits, not in real storage, will be 
indicated by a message. 

Any PDUMP limits may be specified. However, the value of the limits in relation 
to the value X'CO' and to each other determines the output. 




No 



Yes 




No 



Dumping to end 
of storage occurs 
(no wrap-around) 



Yes 



SDAID forces 
lower limit of 
000000 



SDAID selects 
output class of 
LOCORE 



Note: The defaults for the PDUMP limits are the EVENT limits (TlllllV, 'hhhhhh ') 
specified in answer to message 4C61D, refer to Table B- 10. 
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^*^-^^ Output classes 
^^\_^ and 
Recorded ^\^^ Mnemonic 
Information ^*"\^^ 


OUTCL 1 


OUTCL 2 


OUTCL 3 


OUTCL 4 


OUTCL 5 


OUTCL 6 


OUTCL 7 


OUTCL 8 


OUTCL Q 


PSW 
01 


GPR 
02 


LOCO RE 
03 


COMREG 
04 


PAGETAB 
05 


SUPVISOR 
06 


DUMPREAL 
NDD07 


PDUMP 
08 


FASTREC** 
00 


Event ID* 

program old PSW, and time of day 

in microseconds 


X 


X 


X 


X 


X 


X 


Y *»# 


X 


X 


Instruction causing event 


X 


X 


X 


X 


X 


X 


Y*** 


X 




General purpose registers 




X 


X 


X 


X 


X 


X 


X 




Low core (X'000'-X'1 1 F') 






X 


X 


X 


X 


X 






Current COMREG and SYSCOM 








X 




X 


X 






Control registers. 






X 


X 


X 


X 


X 


X 




segment tables, 
page tables, 
page frame table 










X 


X 


X 

¥ 






Complete supervisor 












X 


X 






Complete real address area 














X 






Virtual dump between 
PDUMP address limits 
















X 




TE-MASK 

PER mask (control register 9) 

GPR mask (control register 9) 

PER start address (control register 10) 

PER end address (control register 1 1 ) 

general purpose registers 1 3, 14, 1 5, 0, 1 , 2 


















X 



►-t 

s. 

o 
a 

I 
> 

Si 



Notes 

* Event ID for BR, IF, SA, and GA — event mnemonic and instruction address. 

Event ID for TE — mnemonic TE and address of the page causing TE. 
** FASTREC is an output class that stores the described information into an SDAID internal buffer. 

Information for several events is stored and printed as one block. 
*** INSTR and PSW are not printed if NDD is forced after STOP ON EVENT VIA NDD BYTE X'FF'. 

Table B-6-A . Output class options for SDAID elementary events. 

Examples at the end of this section 2-F show several types of output specified by the output class parameter. 



to 
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Recorded information 


Dedicated Event 


PGMCHK 


PAGENQ 


PAGE HDL 


Event-Mnemonic 

Program old PSW, 

Time of day in microseconds. 

Complete supervisor, 

Instruction at time of PGMCHK 

Control registers 

General purpose registers 


X 






Event-Mnemonic 

Requestor-ID 

(TE/GETR/TFIX/PFIX) 

Task- ID 

Address of page to be handled 




X 


X 


Protection key associated with 
page to be handled 




X 


X 


Address of page frame 

to which the page is assigned 






X 



Table B-6-B. Predefined output obtained from SDAID dedicated events. 



Specification of area to be traced 

For elementary events, two addresses may be specified during SDAID initialization 
as the start and end addresses of the area to be traced or monitored. These 
address limits are interpreted as virtual addresses if the DAT bit in the PSW is on. 
Address limits are not applicable to dedicated events, for which the SDAID 
program includes all real and virtual address areas. 

If the start address specified is higher than the end address, tracing commences from 
the higher address and continues to the end of virtual storage (the maximum 
address being 16,777,215). Tracing continues from address 000000 up to the end 
address (the lower address specified). This is termed "wrap around tracing". 
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Translation exception trace 

This occurs when an instruction requires a page to be paged in from the page data 
set in order for the instruction to be completed. An example is an MVC instruction 
whose address 1 is in page frame x in real storage, and whose address 2 is in page y 
that is not in real storage. 

When this trace is initialized, any page fault generated because of such an instruction 
is printed along with the instruction and its address that caused the page fault, plus 
the output of the specified output class. 

Page enqueue trace 

This trace enables the sequence to be traced in which programs are calling for 
pages. Page faults caused by translation exceptions will also be traced with 
this routine. 

Page handling trace 

This trace provides information about the sequence in which pages are paged in 
from the page data set. After a page is handled, a trace output is printed. 

When to use: Use this trace if you suspect that the loss of a page, or the sequence 
of page usage by a program, is causing programming errors. This trace gives you page 
management information during program execution. 
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Instruction trace 

This trace records information about the order of instruction execution within any 
selected area of storage during program execution. The amount and type of 
information provided depends on the output class selected during initialization of 
the trace. 



When to use: If an unintended loop develops during program execution, this trace 
can be initiated and the program re-run. During the re-run, a list of all the instruc- 
tions executed within the loop will be traced. This is an efficient method to 
obtain a loop trace. 



Storage alter trace 

This trace records information about instructions that alter one or more locations 
in virtual storage between address limits that can be specified. The amount and type 
of information provided depends on the output class selected during initialization 
of the trace routine. 



When to use: If, for example, you suspect I/O areas or count locations for loops, 
information obtained from this trace output will show the instructions that are 
altering the areas. The SA trace will not record changes in the contents of locations 
that are changed directly by I/O channel operations. 



General register alter trace 

This is similar to the virtual storage alter trace. It should be used when information 
about changes to any GR during program execution is required to help during 
offline program debugging. Any GR or any combination of GRs can be traced. 



Successful branch trace 

This trace provides a check on the logical path of a program during its execution 
in any selected part of virtual storage. 



When to use: Use this trace if the actual path taken by a program cannot be 
analysed from the program flowcharts and listings. You can also use it to provide 
information about the path taken, for example, by a long loop. 
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Stop and dump routines SDAIDS 

Stop on event 

This facility stops all system activity on the occurrence of a specified event. At the 
stop on event, the system is held in a wait state. 

Processing continues via external interrupt. 

With the system in this wait state, the operator or programmer can either use 
hands-on debugging aids or obtain a non-destrcying dump. 

The specified event can be one or more of the elementary or dedicated events. 

When to use: 

1. Use this routine if hands-on debugging is necessary on the occurrence of one of 
the specified events. For example, when a change occurs in a general register, 
you may want to look through the program listings to enable you to decide on 
the next step in isolating an error. When the stop occurs, it is also possible to 
initiate another SDAID routine that will provide additional system information 
for offline program debugging. 

2. When no time is available for hands-on debugging, the non-destroying dumps 
obtained when the stop on event occurs will provide a great deal of additional 
information for offline program debugging. 

Stop on address 

This facility provides a stop on address on any specified (real or virtual) address. 
When the stop occurs, the system is held in a wait state, and the operator or 
programmer can use hands-on debugging aids or obtain a non-destroying dump. 

When and how to use: This facility is used under conditions similar to those for the 
hardware stop on address compare, that is, hands-on debugging is to be carried out 
when a program has reached some specific point during its operation. However, this 
aid enables a stop on all SDAID events. 

The stop on address is accomplished by initiating the instruction trace, specifying 
stop on event, and entering the address at which the stop is required as the address 
supplied within the event limit field during initialization of the trace. 
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Non-destroying dump: This is a dump of real storage that can be obtained after 
the occurrence of a specified event during the stop on event. The dump is non- 
destroying because the system is placed in a wait state on the occurrence of the 
specified event, and because SDAIDS do not destroy system status during 
execution of the dump. 

How to obtain the dump: The following procedure describes how to obtain the 
non-destroying dump: 

1 . When the system is in the stop-on-event wait state, locate the real storage 
address of the NDD (non -destroying dump) byte switch. 

The address of this program switch is printed during SDAID initialization. 
Refer to point 3 of the example in this section which shows the SDAID 
initializing output part 2. 

2. To ensure that the wait state is the true stop-on-event wait, use the ALTER/ 
DISPLAY console feature to display the PSW. The instruction address part of 
the WAIT PSW will be OOOOEEEE. 

3. To obtain the dump, set the NDD byte to X'FF', using the ALTER/DISPLAY 
console feature as described in this Section 2-D. 

4. Press the START key and then the EXTERNAL INTERRUPT key. A non- 
destroying dump will be printed and processing continues. 

When the dump is complete, the NDD byte is reset by the SDAID program, and so 
a dump will not occur at the next stop on event. To obtain another dump at any 
following stop, the NDD byte must again be set on. 

Note: The dump can be discontinued by the following procedure: 

1. Make the line printer used as SDAID output device unready. 

2. Now make the printer ready. 

3. Press the EXTERNAL INTERR UPT key two times within one second. 

When to use: This SDAID facility enables you to obtain the information needed 
for problem analysis without having to take dumps of real storage at every 
occurrence of an event. Therefore this decreases the amount of paper to be searched 
through during offline debugging. For example you may consider it sufficient 
for offline debugging to take a dump at every twenty seventh occurrence of an 
event. 
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Dump on a program check: On the occurrence of a program check interrupt codes 
X'01' - X'OF', X'10', and X'12\ the following information is dumped automatically: 
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Event ID 

Program old PSW 

Time of day in microseconds 

Control registers 

General purpose registers 

Real storage from byte location to the end of the supervisor area, and the 

contents of the SDAID buffer. 



After this automatic non-destroying dump is executed, the DOS/VS program 
check handler routine will be entered. 

When to use: If PDAIDS are not available on your system, the use of the SDAID 
dump on a program check is the only way to obtain a non-destroying dump of the 
supervisor transient area at the time of a program check interrupt. 

The SD area 





SUPERVISOR 


'I Real Partitions J 
j if any. (^ 


SUPERVISOR 
















MAIN 
PAGE 
POOL 


MAIN 
PAGE 
POOL 






" V." 


[ SDAID resident code 
1 and work space. 

V SD Buffer 


' 


SD AREA 
(6K by default) 


END OF 
REALST( 


DRAGE 


/ 
END OF 
REALSTC 


3RAGE 


Length of each event is 64 


aytes. 



Real storage allocation 
before initializing SDAIDS 



Real storage allocation 
after initializing SDAIDS 



How to locate 

The address of the beginning of the SD area is printed on the device assigned to 
SYSLST during initialization of SDAID. Refer to page 2.90 for an example of 
SDAID initializing output. 
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Initializing SDAID 

SDAID may be initialized in any real or virtual partition by entering the following 
execute statement via SYSLOG or SYSRDR: 

//EXEC SDAID 

An operator/ system dialog follows, beginning with the message: 

4C55D GIVE SPACE FOR SDAID= 

The operator may respond by pressing the END key (which gives a default value of 
6K to SDAID), or he may specify a value nK, where n represents a multiple of 1024 
bytes. The maximum value that may be specified is 999K. If an odd number is 
specified, the value is incremented to the next even number. The SDAID space is taken 
from the main page pool. If the main page pool is not large enough to accept the 
area specified, the minimum area of 6K is automatically taken. If the page pool is 
not large enough to accept the minimum (6K), the following message is printed 
on SYSLOG. 

4C56E INSUFFICIENT SDAID SPACE, REALLOCATE 

The MAP command should be issued before reallocating real partition areas in 
order to increase the size of the page pool before re-initializing SDAIDS. 

The following message will be issued if this is a second request for SDAID space: 

4C70E DUPLICATE REQUEST FOR PDAID AND/OR SDAID 

This message is also issued if PDAID using the core wrap output mode in an 
alternate area is active in the main page pool and a request for SDAIDS is made. 
When the space allocated to SDAID is accepted, a message dialog follows that allows 
the operator to select one or more events to be traced and to specify between which 
address limits of real or virtual storage the events are to be traced. (Event limits 
do not apply to event PAGENQ, event PAGEHDL, and event PGMCHK.) The dialog 
also enables the selection of a line printer at a device address other than X'OOE', 
which is the device address by default. However, the device must be a line printer. 

An output class may also be specified (refer to Tables B-6-A and B-6-B in this chapter). 
A response of EOB (pressing the END key) to all SDAID messages will give default 
values. 

When the SDAID message dialog is complete, the SDAID initializing outputs part 
1 and 2 are issued to the device assigned as SYSLST. This need not be the same 
device on which SDAID trace output is printed. The SDAID trace output is printed 
immediately after the initializing output on the device at the address specified in 
the reply to message 

4C58D OUTPUT DEVICE= 

(Address X'OOE' is taken as default.) After initialization, the partition used for the 
initialization is given back to the main page pool. 

The table shown in Figure B-3 lists all SDAID messages in the order in which they 
are issued and describes the responses. 

SDAID job entry examples are shown after the example of the SDAID initializing 
output. Operator flowcharts follow. 

SDAID messages after initialization time 

4C71I SDAID FOUND PRTR STATUS CSW SENSE 

This message may be written out on the printer. It is accompanied by the CSW and 
SENSE information if applicable. It indicates that the previous printer operation 
which was started may not have been completed successfully. 
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Altering SDAID functions and /or address limits after initialization 

When the SDAID is initialized, trace functions and events limits, where applicable, 
can be changed by altering the SDAID program parameters directly in storage. 
The contents of the parameters at the addresses printed on part 2 of the SDAID 
initializing output, and of control registers 8, 9, A, and B, must be altered to 
predetermined values. Their values are also printed in the initializing output. 

To make SDAID parameter changes: 

• Press the STOP key. 

• Use the console ALTER/DISPLAY feature to alter the contents of the 
program parameters. 

• Press the START key. 

Note: When SDAID is terminated and later re-initialized, new SDAID parameters 
are printed in the SDAID initializing output. 

Note: SDAID requires SYSLST for the initializing output. Therefore, if you 
intend to change SDAID parameters after initializing SDAIDS, you should ensure 
that the SYSLST device is a line printer on the partition used for SDAID 
initialization. 
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A note to programmers 

SDAIDS are primarily designed to be initialized before re-running failing programs. 
If you, as the programmer, are debugging on the system (hands-on debugging), it 
is recommended that you initiate SDAIDS without specifying any events. (Press 
the END key as a response to all SDAID messages.) SDAID is then retained in the 
page pool ready to be activated. The failing programs can then be executed and 
SDAID events made active by entering event parameters directly into control 
registers 8,9, 10, and 1 1 . For example, altering the contents of the high-order byte 
of control register 9 (by the console ALTER/DISPLAY feature) enables you to 
activate any one or all of the events BR, IF, SA, and GA. 

You can also specify which general registers are to be traced by entering values 
into the lower 2 bytes of control register 9. Control registers 10 and 11 contain, 
respectively, the start and end addresses for the event limits. The output of the 
MAP command will tell you the partition in which the failing programs reside. 

From the MAP output you can also obtain the addresses of the upper and lower 
limit of the partition, which can then be used as the event limits for the SDAID 
trace. (Note that addresses printed by the MAP command are decimal.) 

If you are unable to use the system for hands-on debugging, you as the programmer 
must specify clear instruetions to the operator about the events to be traced and 
the event limits to be used. 
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tJD KeSfONSE QfrOSES ^VSIE-M to 

-f A K £ £ F^vo tr o -p-< * «* • 



Message 
Code 



Message issued 
on SYSLOG 



Parameters entered by Operator 



Remarks 



4C58D 



OUTPUT DEVICE= 



X'OOE ' [,GO]' 
X'cuu' [,GO] 
GO 



END/ENTER 



4C60D 



STOP ON EVENT= 



YES 
NO 



[.GO] 



END/ENTER 



4C61D 



EVENT LIM!TS= 



XWOOOOVCTF£FFP_ [,GO] 
. X'llllM' [,GO] 

,X'hhhhhh' [,GO] 
,GO 



X'llllll' 



END/ENTER 



X'Mllll',X'hhhhhh': 

Lower and upper limit of virtual 
storage to be traced with events 
BR, IF, SAandTE. 



4C59D 



OUTCL= 



PSW 

GPR 

LOCORE 

COMREG 

PAGETAB 

SUPVISOR 

DUMPREAL 



,GO 



PDUMP 



FASTREC 



,lower and upper event limit [,GO] 



,X'aaaaaa' 



.GO 



.Upper event limit [,GO] 
,X'bbbbbb' CGO] 
L,GO 



. PGMCHK [,GO] 
.AUTOMATIC [,GO] 
,GO 



END/ 
ENTER 



Valid output classes for the events 
BR, IF, SA, GA,andTE. 
END/ENTER 

PGMCHK: Causes wrap around 
mode of internal buffer. It is 
written each time a PGMCHK 
event occurs. AUTOMATIC: 
If the internal buffers is full, 
it is written out. 



4C62D 



EVENT BR= 



YES 
NO 



[GO] 



END/ENTER 



4C63D 



EVENT IF= 



YES 
NO 



[go] 



END/ENTER 



4C64D 



EVENT SA= 



YES 
NO 



r.Gbi 



END/ENTER 



4C65D 



4C66D 



EVENT GA= 



X'012...EF' [,GQ] 
NO 



END/ENTER 



Designate the general purpose 
registers to be traced. At least 
one must be specified. 



EVENT TE= 



Er h 



END/ENTER 



4C67D 



EVENT PGMCHK= 



W L^ 



END/ENTER 



4C68D 



EVENT PAGENQ= 



YES 

NO 



iGOl 



END/ENTER 



4C69D 



EVENT PAGEHDL= 



YES 

NQ 



END/ENTER 



Note: If GO is entered for a parameter, the dialogue is terminated immediately and defaults (underlined) are taken for the remaining 
parameters. J) JEpPt Ui_T £, 

Table B-10. The parameters required to initialize SDAID event tracing. 
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//JOBSDTRACE 
//EXECSDAID 



4C53I TOD IN ERROR STATE 



or 



4C54I TOD NOT OPERATIONAL 



Select size of SD area 



Enter n 
(a value) 



Press 
END 



4C70E DUPLICATE REQUEST FOR PDAID 
AND/OR SDAID 




NO 



SDAIDS 
Initializing SDAID, part 1 of 6 



§/Vo operator response is required to 
^either of these messages if they are 
iprinted. The time stamp on SDAID out- 
%put will be zero. 



(Maximum area you may specify is 999k. 
II f n is an add integer, the value is 
(incremented to the next even number. 



I This message is issued if SDAID has 
Ibeen initiated and not terminated before 
la second request to initiate SDAID is made. 
%The duplicate, or second request for 
ISDAID is automatically canceled. (This 
^message is also printed if a request to run 
la PDAID core-wrap output in an alter- 
inate area is made while SDAID is active . 



Yes 



SD area size 
is nK 




No 



SD area size 
is6K 



4C58D OUTPUT DEVICE = 



Device X'cuu' must 
be a line printer 



4C56E INSUFFICIENT SDAID SPACE 
REALLOCATE 



Select a device 



Enter 
X'cuu' and 



Enter 
GO 



Enter 
X'cuu' 



or ~~ or T 

GO and press END I and press END] and press END 



Press 
END 



Use device 
X'cuu' for 
output 



Use device 
X'OOE' for 
output 



Use device 
X'cuu' for 
output 



If this message is printed, the SDAID job 
is terminated. Before re-initializing 
SDAIDS you must decrease the size of 
real partitions, thus increasing the size 
of the main page pool for the SD area. 



Use device 
X'OOE' for 
output 





To part 2 



To part 2 
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Initializing SDAID, part 2 of 6 



From part 1 



From part 1 




4C60D STOP ON EVENT = 



Enter GO 
and press 
END 



Enter YES 

and GO 

and press END 



Enter YES 
and Press 
END 



Press 
END 



No stop 
on event 



■*■ 



Trace events 
across all of 
virtual storage 



Refer to Table B-6-A for a 
description of SDAID output 
classes. 

(FASTREC,GO generates the 
default of PGMCHK). Output 
class for the events PGMCHK, 
PAGENQ, and PAGEHDL is 
predetermined. Refer to 
Table B-6-B 



Stop 
on event 



Stop 
on event 



No stop 
on event 



4C61D EVENT LIMITS 



Enter GO 
and press 
END 



Specify event limits and 



Enter GO and 
press END 



Press 
END 



Trace events 
between limits 
specified 



Trace events 
between limits 
specified 



Use output 
class specified 



Take default 
output class of 
PSW(01) 



Use output 
class specified 



Press 
END 



Trace events 
across all of 
virtual storage 




Take default 
output class of 
PSW(01) 



^ ' 



To part 3 



To part 3 
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From part 2 



Enter GO 
and press 
END 



No BR trace 



No IF trace 



To part 4 



From part 2 



SDAIDS 
Initializing SDAID, part 3 of 6 



4C62D EVENT BR = 



BR = Successful Branch Trace 



Enter YES and 



Enter GO and 
press END 



Trace BR 
events 



Enter GO 
and press 
END 



Press 
END 



Press 
END 



Trace BR 
events 



No BR trace 



4C63D EVENT IF = 



IF = Instruction Fetch Trace 



Enter YES and 



Enter GO and 
press END 



Press 
END 



Trace IF 
events 



Press 
END 



Trace IF 
events 



No IF trace 



-_r 



To part 4 
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Initializing SDAID, part 4 of 6 



From part 3 



From part 3 



4C64D EVENT SA = 



SA = Storage Alter Trace 



Enter GO 
and press 
END 



Enter YES and 



Enter GO and 
press END 



Press 
END 



No SA trace 



Press 
END 



Trace SA 
events 



Trace SA 
events 



No SA trace 



4C65D EVENT GA = 



Enter GO 
and press 
END 



GA = General Purpose Register Trace 



Specify GPR(s) to be traced, (in hex) 



Enter GO and 
press END 



Press 
END 



No GPR trace 



Trace GPR(s) 
specified 




Press 
END 



Trace GPR (s) 
specified 



No GPR trace 




To part 5 



To part 5 
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From part 4 




Enter GO 
and press 
END 



No TE trace 



From part 4 



SDAIDS 
Initializing SDAID, part 5 of 6 



4C66D EVENT TE = 



TE = Page Translation 
Exception Trace 



Enter YES and 



Enter GO and 
press END 



Press 
END 



Trace TE 
events 



Press 
END 



Trace TE 
events 



No TE trace 



*J 



4C67D EVENT PGMCHK= 



Enter GO 
and press 
END 



Enter NO and 



Enter GO and 
press END 



Press 
END 



Trace 
PGMCHK(s) 



PGMCHK = Program check trace 



Do not trace 
PGMCHK(s) 



ZJ 



Do not trace 
PGMCHK(s) 



Press 
END 



Trace 
PGMCHK(s) 



J 



To part 6 



To part 6 
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Initializing SDAID, part 6 of 6 



From part 5 



From part 5 



4C68D EVENT PAGENQ = 



Enter GO 
and press 
END 



PAGENQ = Trace of page requests 
as they are placed in the page queue 



Enter YES and 



Enter GO and 
Press END 



Press 
END 



No PAGENQ 
trace 



Trace 
PAGENQ(s) 



PAGEHDL = Trace of pages as they 
are allocated to a frame in the real 
address area — page request is 
removed from the page queue. 



Press 
END 



Trace 
PAGENQ(s) 



No PAGENQ 
trace 



ZJ 



4C69D EVENT PAGEHDL 



Enter YES 
and press 
END 



No PAGEHDL 
trace 



Press 
END 



Trace 
PAGEHDL 



No PAGE- 
HDL trace 



SDAID initializing output parts 1 and 2 are printed at this 
point during the initialization. The example opposite 
shows and explains the meaning of the initializing output. 
Retain this output if SDAID parameter changes are 
intended after initialization. 



4C57E SDAID SUCCESSFULLY INITIATED SDAREA=XXXXK 
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SOAIO FOUND/ASSUMED THE FOLLOWING PARAMETERS: 

SOAID START ADDRESS IS HEX 0003E800 

SDAID END ADDRESS IS HEX 0003FFFF 

SDBUFFER START ADDRESS IS HEX 00O3FDCO 

SOBUFFER END ADDRESS IS HEX 0003FFFF- 

SDBUFFER CAN KEEP THIS NR OF EVENTS OEC 00000009 



1 PRINTER ADDRESS IS HEX 

2 OUTPUT CLASS FIELD IS 

3 STOP ON EVENT 

* EVENT LIMITS START HEX 

END HEX 

5 EVENT BR 

6 EVENT IF 

7 EVENT SA 

8 EVENT GA 



OOOE 
PSU (Oil 



00000000 
OOFFFFFF 



MASK BITS FOR GENERAL PURPOSE REGISTERS .0123456789ABC0E 



oooooooooooooooq 



9 EVENT TE 

10 EVENT PGMCHK . 

11 EVENT PAGENQ . 

12 EVENT PAGEHDL. 



3FFFF- -3E900 - I7FF * 6/£-3<*6c| 



(c/if \ % sidec/- <;/} faux, on <?/??■ »*£. 

Vn&T 100O0ZOO tnCAJ 

5 a**/ 7 e+t&r i<?<?0f5oo 






(£xZ3«r)\ 



SDAID initializing output, part 2 



**** THESE ARE THE PARAMETERS THAT YOU CAN CHANGE FROM CONSOLE: 

* PROCEDURE: MACHINE IN STOPPED STATE, HIT ALTER/DSPLY, EXAMPLES BELOW: 
* 

* TO ALTER CTL REG 9 TO 40000000 

* TVPE IN AC 9 40000000 END KEY 

* 

* TO ALTER MS LOCATION 03CC8C TO FF 

* TYPE IN AM 03CC8C FF END KEY 

* 
* 

**1 PRINTER ADDRESS ON HEX 03FD88 FORMAT OXXX 

* 

**2 OUTPUT CLASS ON HEX 03F098 FORM UUYY 

* WHERE IF: UU=00 FASTREC 

* UU=01 PSW 

* UU=02 GPR 

* UU=03 LOCORE 

* UU=04 COMREG 

* UU=05 PAGETAB 

* UU=06 SUPVISOR 

* UU=07 OUMPREAL 

* UU=08 PDUMP 

* YY=00 AUTOMATIC SDBUFFER OUTPUT 

* YY=FF SDBUFFER OUTPUT ON PGMCHK 
• 
**3 STOP ON EVENT ON HEX 03FD94 X'FF^YES, X'OC 

* NONDESTROYING DUMP ON HEX 03FD96 X'FF'=YES 

• 

**4 EVENT LIMITS START ADDRESS .... CTL REG A HEX OOXXXXXX ADDR 

* END ADDRESS .... CTL REG B HEX OOXXXXXX ADDR 
* 

* PDUMP LIMITS START ADDRESS .... ON HEX 03FD9C OOXXXXXX ADDR 

* END AODRESS .... ON HEX 03F0A0 OOXXXXXX ADDR 
• 
* 

* SDAID EVENTS: TO ENABLE — SWITCHON THE BIT/BYTE— 
• 

**5 BR EVENT CTL REG 9 HEX 80000000 BIT 

**6 IF EVENT CTL REG 9 HEX 40000000 BIT 

»*7 SA EVENT CTL REG 9 HEX 20000000 BIT 

* 

**8 GA EVENT CTL REG 9 HEX 10000000 BIT 

* GPR MASK 10-15) .. CTL REG 9 HEX 1000XXXX POSITIONAL 
* 
**9 TE EVENT MAIN STORAGE 03F08C HEX FF BYTE * 

* * 

* 10 PGMCHK EVENT MAIN STORAGE 03FD8E HEX FF BYTE * 

* . - * 

*11 PAGENO EVENT MAIN STORAGE 03FD90 HEX FF BYTE * 

»12 PAGEHDL EVENT MAIN STORAGE 03FD92 HEX FF BYTE * 

* * 
♦NOTE: SDAID NEEDS EXTERNAL INTERRUPT IF PRINTER BECAME UNREADY • 

* * 

* * 
******************************************************************************** 

CPU-ID IS HEX P0010043,Q145POCQ, 

4C57E SDAID SUCCESSFULLY INITIATED SDAREA=0006K " '^-*- , —r- r 

r y ^ ^ - CfiV M<r 

CPU S( 



%/VCtfK. 

- % -r fr -■ C . tTw&f CO <*. 
fyi-/ ' 5. £"■»<%■ So . 






~as-e*c 



Czx&kt) 



The summary of parameters printed on the line printer 
after successful initialization of any SDAID routine. 



ALL ADDRESSES ARE REAL. 
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1I60A READY FOR COMMUNICATIONS, 
batch f2 

a s s wi s y s I s t » x ' OOeJ^_— 

// exec s da i d * — 

4C55D GIVE SPACE FOR SDAID = 

10k 

4C56E INSUFFICIENT SDAID SPACE r REALLOCATE 

1I00A READY FOR COMMUNICATIONS. 

map 

AREA K-REAL UPPER LIMIT K-VIRT UPPER LIMIT 



/99 



92K 
30K 
10K 
10K 
14K 
82K 



18K 
flr-14k 
: s da i d *" 



94207 
124927 
135167 
145407 
159743 
243711 



262143 



292K 
SOK 
80K 
100K 
120K 
96K 
68K 



262144 
561151 
643071 
724991 
827391 
950271 
1048575 
1048575 



NAME 



KENSLOOP 



NO NAME 



y MAP -trmoititnrt 



4C55D GIVE SPACE FOR SDAID 

10k 

4C58D OUTPUT DEVICE = 

4C60D STOP ON EVENT = 

4C61D EVENT LIMITS = 
x '040000' rx'OSOfff ' 
4C59D OUTCL = 



4C62D 

Yes 

4C63D 

yes 

4C64D 



EVENT BR = 



EVENT IF = 
EVENT SA = 






4C65D EVENT GA = 

x' 345678' 

4C66D EVENT TE = 

4C67D EVENT PGMCHK = 

4C68D EVENT PAGENQ = 

4C69D EVENT PAGEHDL = 



&WW ste&c&aO St 



4C57E 
1I00A 
* *- 



SDAID SUCCESSFULLY INITIATED 
READY FOR COMMUNICATIONS. 



SDAREA=0010K 






SDflID J-ea>tni jOm*fteetetJ£fy' 



J00040000I , 
FFFFFFFF 1 



J00050FFF'| 00000000 00000000 C2000000 00000200 80400040 
FFFFFFFF 00000000 00000000 00000000 00000000 OOOOFFFF 



OR // X'b' <c**diut4 UuL tdJuif e+>ctU Jk+c-w 



I000404EAI 



AC A 
( 6604043C I 

DC 9 _ 

D0001F80 1 0004043CU I060404EAT. , 00000000 00000000 C2000000 00000200 80400040 

O0O0F60O FFFFFFFF ) FFFFFFFF^ 00000000 00000000 00000000 00000000 OOOOFFFF 

Pr+rUtj- -matdi V. v_ CA /O a**/ // eUfu/e* £a odeeseauLU, 



F2 



AC 9 
00000000 



Cjk*s CA f & £Z*t *£/ e^^nA \ &>c**fisf &**<f/f<M< 



The example above shows the operator-system dialogue on a 3215 PRKB during SDAID initialization. 

After initialization the contents of the control registers have been changed to alter event limits 
and traces. 
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IF GA 

GPR 0-7 
GPR 8-F 
CTL 0-7 
CTL 8-F 
LOW CORE 
00000000 
00000020 
00000040 
00000060 
00000080 
OOOOOOAO 
OOOOOOCO 



Cp00404 3C ) tod micsec 

00000000 OOD2FO0O 00000030 

00000001 00000833 OOOOOOOF 
004000FF 0O0OE64O FFFFFFFF 
OOOOFFFF D0001F80 0004043C 



2333024913754652 

00000000 00000000 
4004007A 0004107A 
FFFFFFFF 00000000 
000404EA 00000000 



PSW AT TIME OF EVENT 471D00000004043E INSTR] 
0000008E 000000 10 00000002 
D7C8C1E2 B0040426 000422F8 
00000000 00000000 00000000 
00000000 C2000000 00000200 



< T* 3. 3 



oooooooo oooooooo oooooooo 

471D3000 0004043A 47100000 

OOOOOOOO 04000000 10003B70 

440C0O00 OOOOOBCC OOOCOOOO 

00000540 00000080 0002000A 

<- 00000 20000060 

iT 00000 oooooooo 

SEGM TABLE/_ 0000E6 4Q 

0OOOE640 ,'F06" 0E330l F0OOE370 F000E3B0 

0OOOE660 >"o60E53Ol£O0OE57O F000E5B0 

PAGE TABLES 00O0E330~~ 

0000E320 0080000 8 OOOOOOOO OOOOOOOO 

OOO0E340 

0000E360 

0000E380 

00OOE3A0 

0OOOE3C0 

0000E3E0 

0000E4O0 

0OO0E420 

0000E440 



OOOOOOOO 
0004043E 
OOOOOOOO 
0003B000 
00020080 
0O0O02C0 
OOOOOOOO 



OOOOOOOO 
OOOOOOOO 
00B62900 
04080000 
12042003 
OOOOOOOO 
OOOOOOOO 



000004AO 470F2000 0000090C 
0003B174 471DO00O 0004044A 
02FDB4D4 440COOOO 00OO0C14 
0000D13A 440C0000 OOOOOBIO 
00025000 0004043C 000001CC 
00000100 00000009 OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO 






FO0OE3F0 
F000E5F0 



F00OE430 F000E470 FO00E4BO F000E4F0 

oooooooi oooooooi oooooooi oooooooi 



J S e 07"wf' 



i.U.O.U.O.UO 



00400048 00500058 00600068 007000 
00C000C8 00D000D8 OOEOO0E8 0OFO0OF8 
01400148 01500158 01600168 80118011 
80118011 80118011 80118021 80218021 
80418041 80418041 80418041 80518051 
80018001 80018001 80018001 80018001 
80018001 80018001 80018001 80018001 
03C103C9 03D103D9 03E 10369 03F103F9 
00150015 00150015 00150015 00150015 
— SAME— 

00150015 00150015 00150015 00150015 
00250025 00250025 00250025 00250025 
— SAME — 

00250025 00350035 00350035 00350035 
00350035 00350035 00350035 00350035 
00350035 00350035 00350035 00350035 
00450045 00450045 00450045 00450045 
— SAME — 

00450045 00450045 00450045 00450045 
00550055 00550055 "A~ £* "50055 

—SAME— /W/7- O 

00O0E620 00550055 00550055/^ 150055 

PAGEFR TAB OOO0DE88 1| 

000O0E8O 000 88 000 OOOOOO O O 100020000 OOOO0Q.0O.' 
00020000 00030000 00020000" 66o4oo"oo 
00020000 00070000 00020000 00080000 
00020000 OOOBOOOO 00020000 OOOCOOOO 
00020000 OOOFOOOO 00020000 00100000 
00020000 00130000 00020000 00140000 
00020000 00170000 00020000 00180000 
00020000 001BOOOO 00020000 001C0000 
00020000 001FOOOO 00020000 00200000 
00020000 00230000 00020000 00240000 
00020000 00270000 00020000 00280000 
00020000 002B0000 00020000 OO2C0000 
00000418 00800188 000001A8 FFFF0190 
00000410 008301A0 00000198 00820170 
000001CO FFFF01B0 000001C8 FFFF01B8 
000001EO FFFF0100 000001E8 FFFF0108 
00000200 FFFF01F0 00000208 FFFF01F8 
00000220 FFFF0210 00000228 FFFF0218 
00000240 FFFF0230 00000248 FFFF0238 
00000260 FFFF0250 00000268 FFFF0258 
00000280 FFFF0270 00000288 FFFF0278 
000002AO FFFF0290 000002A8 FFFF0298 
000002CO FFFF02B0 000002C8 FFFF02B8 
000002EO FFFF0200 000002E8 FFFF02D8 
00000300 FFFF02FO 00000308 FFFF02F8 
00000320 FFFF0310 00000328 FFFF0318 
00000340 FFFF0330 00000348 FFFF0338 
00000360 FFFF0350 00000368 FFFF0358 
00000380 FFFF0370 00000388 FFFF0378 
000003AO FFFF0390 000003A8 FFFF0398 
0003O3C0 007703A8 000303C8 007803A8 
00030190 007BO3E0 00030190 007C03E8 



>OfrToOO~o})008 00100018 00200028 00300038 
178 f~"~""' 



O0OOE4A0 
0OOOE4CO 

0000E500 
O0OOE52O 
0000E540 
0000E560 

0000E5A0 
0O0OE5CO 



OOOOOEAO 
OOOODECO 
OOOOOEEO 
OOOOOFOO 
0000DF20 
00O0OF40 
0000DF60 
000 OOF 80 
OOOODFAO 
OOOODFCO 
OOOOOFEO 
OOOOEOOO 
0000E020 
0O0OEO40 
0000E060 
0O0OE080 
OOOOEOAO 
OOOOEOCO 
OOOCEOEO 
0000E100 
0O0OE12O 
0OOOE140 
00OOE160 
OO0OE180 
0000E1A0 
0O00E1C0 
0000E1E0 
0000E200 
0000E220 
0OO0E240 
O0OOE26O 



900098 00A000A8 00B00088 
/^a&t O 100118 01200128 01300138 
118011 80118011 80118011 

80218021 80318031 80318031 80318041 
80518051 80518051 80518001 80018001 
80018001 80018001 80018001 80018001 
80018001 80018001 80018001 03B103B9 
01790171 01A10199 01890015 00150015 
00150015 00150015 00150015 00150015 

00150015 00250025 00250025 00250025 
00250025 00250025 00250025 00250025 

00350035 00350035 00350035 00350035 
00350035 00350035 00350035 00350035 
00350035 00450045 00450045 00450045 
00450045 00450045 00450045 00450045 

00450045 00450045 00550055 00550055 
00550055 00550055 00550055 00550055 

OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO , 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00000178 
000001 BO 
000001 DO 
000001F0 
00000210 
00000230 
00000250 
00000270 
00000290 
000002B0 
000002DO 
000002 FO 
00000310 
00000330 
00000350 
00000370 
00000390 
00000400 
000303DO 
00030190 



00010000 
00050000 
00090000 
OOODOOOO 
00110000 
00150000 
00190000 
001D00OO 
00210000 
00250000 
00290000 
002D0000 
00840418 
FFFF0180 
FFFF01C0 
FFFF01EO 
FFFF0200 
FFFF0220 
FFFF0240 
FFFF0260 
FFFF0280 
FFFF02A0 
FFFF02C0 
FFFF02E0 
FFFF0300 
FFFF0320 
FFFF0340 
FFFF0360 
FFFF0380 
FFFF03A0 
007903A8 
007D0188 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
000001AO 
00000180 
000001B8 
000001D8 
000001F8 
00000218 
00000238 
00000258 
00000278 
00000298 
OO0OO2B8 
000002DB 
000002 F8 
00000318 
00000338 
00000358 
00000378 
00000398 
000303B8 
00030400 
00030198 



00060000 

OOOAOOOO 

OOOEOOOO 

00120000 

00160000 

001A0000 

OOIEOOOO 

00220000 

00260000 

002A0000 

00810410 

FFFF0400 

FFFF01A8 

FFFF01C8 

FFFF01E8 

FFFF0208 

FFFF0228 

FFFF0248 

FFFF0268 

FFFF0288 

FFFF02A8 

FFFF02C8 

FFFF02E8 

FFFF0308 

FFFF0328 

FFFF0348 

FFFF0368 

FFFF0388 

007603A8 

007A03A8 . 

007E03F8 J 



)/<ZMr/n 



rtl9*K~ 



(iX 3o KT)\ 



An example of dumping the page tables and low address storage on an event. 




Serviceability Aids. 2.97 



Trade Routines 

SDAIDS 



r 



st> 



EVENT ADDR OR PAGE AOOR 
MC-CLASS +COOE 
EVENT-ID PSH 

TE 050000 471D200OOOO410EE 
TE 04F800 471D2000000410EE 
TE 04F000 47102000000410EE 
TE 04E800 471D2000000410EE 
TE 04E000 471D2000000410EE 
TE 0*0800 471D2000000410EE 
TE 040000 471020000004144C 
TE 060800 47102000000422C8 
TE 042800 47101000000406EA 



TOD DEC NIC SEC 
2333039363651268 
2333039363711212 
2333039363794504 
2333039363852338 
2333039363912247 
2333039363969936 
2333039364088211 
2333039407337972 
2333039407342990 



EVENT MASKING 
PER UNITS 
E GPRS LOWER UPPER 
0000 000000 FFFFFF 
0000 000000 FFFFFF 
0000 000000 FFFFFF 
0000 000000 FFFFFF 
0000 000000 FFFFFF 
0000 000000 FFFFFF 
0000 000000 FFFFFF 
0000 000000 FFFFFF 
0000 000000 FFFFFF 



GPR 13 
00O402E0 
000402EO 
000402EO 
000402EO 
000402E0 
000402E0 
00040 2E0 
F6041E28 
F0040078 



GPR 14 
8004108C 
8004 108C 
8004 108C 
8004 108C 
8004 108C 
8004 108C 
80041414 
800405A6 
A004U2E 



GPR 15 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
900417EC 
8004114C 



EVENT PGM CHK INTERRUPT TOO MICSEC 



GPR 0-7 
GPR 8-F 
CTL 0-7 
CTL 8-F 
LOW CORE 
00000000 
00000020 
00000040 
00000060 
00000080 
OOOOOOAO 
OOOOOOCO 



00000018 00040910 00000021 
00000000 00000000 00000000 
004000FF 0000E640 FFFFFFFF 
OOOOFFFF 00000000 00000000 

00000000 00000000 00000000 



47100000 000422DC K71D3000 00040718 



1000E718 08000000 1000E710 
440C0000 OOOOOBCC OOOCOOOO 
00000540 00000000 00020007 
00000000 00000000 20000060 
00000000 00000000 00000000 
— SAME — 
SUPERVISOR 
00000120 00000000 00000000 00000000 

— SAME — 
000004A0 F1F261F0 F661F7F3 70007000 
000004CO 00060FFF 0004232F 0004232F 
000004EO 41044296 42974389 3F003F06 
00000500 46300000 3DCC3E4C 3E8C0010 
00000520 00000000 04A010EO 00000588 
00000540 00006140 00002ECA 080407C0 
00000560 00017000 080050E6 0032002C 
00000580 60800800 000008FC 00009260 
000005A0 00000000 00007998 00006360 



2333039515946093 PSH AT TIME OF EVENT 471D30000004. 
00000002 0000002E 00000000 00000000 00000000 
4004007A 0004107A 07C8C1E2 A00406EE 000422A0 
FFFFFFFF 00000000 00000000 00000000 00000000 
OOFFFFFF 00000000 OOOOBOOG C200O0O0 00000200 

^- /^a -cA&Jt ot.o />sw 

OOOOOOOOA OOOOOOOff 000004A0 40000000 00000000 
00000000 0003E974 470C2000 0000090C 
FC4F0500 023E32CD 440C0000 0O0O0C14 
04080000 0OOOD13A 440C0000 00000810 
12042003 00020000 00000000 000001CC 
00000000 00000100 OOOOOOOE 00000000 
OOOOOOOO 00000000 00000000 00000000 

00000000 00000000 00000000 00000000 00000000 

00000000 00000000 00000000 C2E4C7D7 09C7C3D2 

00000010 0008FFFF FD7FCE03 30A0CED0 002E40FD 

3F0C38F1 F2F0F6F7 F3F3F4F0 00003CD4 0000003C 

00000000 00008090 00007118 00003864 3BD45A30 

C0C00340 40404040 40404000 40404040 40404000 

00004134 000026C4 00004888 00005854 000082E8 

00050000 0000700C 00000000 00008299 000060B8 

00005F78 00006068 000060C0 00000010 000074BO 

00003854 00000638 00008099 00004246 00000760 



GPR GPR 1 GPR2 
00000002 OOOOE003 0004102A 
00000002 0000E50A 00041E84 
00000002 OOOODD06 00041F04 
00000002 00000506 00042138 
00000002 0O0OCDO4 00042250 
00000002 0000C502 0004235C 
00000002 0O0OBO51 0004245E 
00000080 00040B1A 000403F4 
00040078 00040B1A 00000001 

INSTR (£§03C676C5EC 

*&oy/sr- 
-* 6 



toy/ z 



BUGPRGCK 

L 

. 120673340... M.... 



6r*i 



An example showing the output to device X'OOE' (a line printer) after specifying 
a "dump on program check" and a page translation exception trace using output 
class FASTREC, AUTOMATIC 

Notice that the SD buffer is dumped before the dump of the supervisor and real 
storage. (A system dump would follow the SDAID dump if it was requested, refer to 
A- 2 in this Section for a description of the system dump.) 



BHIF 
GP* 0-7 
GP1 8-F | 
CTL 0-7 
CTL 8-F 
L3H CORE 
00000000 
000 000 20 
00000040 
00000060 
00000080 
OOOOOOAO 
OOOOOOCO 



^ V000400C6) TOO MICSEC 
00303003 00040VE8 00003FE0 
80041088 00041084 40041032 






2327688745012422 
0004D7A1 00000004 00000001 
00040088 00041888 00042888 
FFFFFFFF 00030000 00000000 
00040660 00000000 00000000 



PSH 470D000000040E78 INSTR ,47F0BDFqft7F0 



Cotlg, 



00008CA0 OCOOOOOO 00003860 
440:0000 0OO00C4E OOOCOOOO 
00D00540 00000080 00020040 
00000000 OOOOOOOO 20000060 
00000000 OOOOOOOO OOOOOOOO 
— SAME-- 
C01REG IOC 000004AO 
000004AO F1F061F0 F561F7F3 70007000 
000004CO 00088FFF OOO4201B OOOOOOOO 
000004EO 3FD841A6 41A74299 3DD03DD6 
00000500 45400000 389C3C1C 3CBC0010 
00000520 OOOOOOOO O4AO10EO 00000588 
00000540 000063E8 00002BFE 083607F0 
00000560 00017000 0700608E 0032002C 
SYSCOM LOC 00000540 
00000540 000063E8 00002BFE 083607F0 
00000560 OOOL7000 0700608E 0032002C 
00000580 60800840 00000952 00009488 
C00005AO 0000063C 00007D40 00006608 
000005CO 00003156 0000A264 000006E4 
000005EO 00081018 00200000 OOOOOOOO 
00000600 OOOOOOOO OOOOOOOO oooooooc 
00000620 00006680 OOOOOOOO 00002972 
00000640 OOOOOOOO OOOOOOOO 00003CDO 



OOOOOOOO 
00043E78 
OOOOOOOO 
0003 BOOO 
00040380 
000002C0 
OOOOOOOO 



OOOOOOOO 
00303010 
30DC38F1 
00000300 
COC00740 
00004000 
00050000 

00004000 
00053000 
00006220 
00003594 
OOOOOOOO 
OOOOOOOO 
01710001 
0003FFFF 
000038C6 



OOOOOOOO 
OOOOOOOO 
FD083EOO 
04080000 
12042803 
OOOOOOOO 
00000300 



OOOOOOOO 
OOOFFFFF 
F0F0F5F7 
000084BC 
404040 40 
00009A00 
000072B4 

00009AOO 
000072 B4 
00006310 
00000660 
0000D960 
OOOOOOOO 
OOOOF600 
000086C8 
OOOOOOOO 



000004AO 
OOOOOOOO 
02583606 
0003B188 
0002C000 
OOOOOIOO 
OOOOOOOO 



OOOOOOOO 
FD7FFE03 
F3F2F7F8 
000074B8 
40404000 
00004798 
OOOOOOOO 

00004798 
OOOOOOOO 
00006368 
000084C5 
00009088 
000036 72 
0000ED38 
A00E8000 
OOOOOOOO 



00000006 80041BOO 
000004AO 00000540 
OOOOOOOO OOOOOOOO 
C2000000 00000200 

471D1000 0004047A 
470F2000 00000962 
440COOOO 00000CC8 
440C0000 00O0OB92 
000400C6 000 001 : 8 
00000130 OOOOOOOO 
OOOOOOOO OOOOOOOO 



D2C5D561 E3D6D4E2 
3000FED0 O0C63FD1 
00003AA4 0000003C 
000035A4 39A45C04 
40404040 40404000 
O0O05AF8 000087CO 
0000876A 00306360 



O0O05AF8 
0303876A 
00000010 
0000414A 
00003838 
OOOOOOOO 
OO00F160 
OOOEFOOO 
000006BO 



000087CO 
00006360 
00007850 
00000790 
OOOOOOOO 
OOOOOOOO 
00006620 
OOOOOOOO 
07241D54 









Oufta/' a&ao COM 7? £■ $ 
&ve>nJ5 BR a^ I F. 
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An example of dumping the active communication region and low address 
storage on an event. 



2.98 Serviceability Aids. 



Trace Routines 

SDAIDS 



























m II JOB 0EBUGEX1 

• // OPTION NODECK.LIST, 
// EXEC ASSEMBLY 

• PAGENQ PAGE 000*0800 


XREF.L 


NK.LOG.DUMP 

KEY 1 


TASKID 1 


REQUID 03 


DATE 12/06/73, CLOCK 11M9/33 


y^- 






_ PAGEHDL 


PAGE 000*0800 


FRAME 


00018800 KEY 1 


TASKID I 


REQUID 03 


TFIX 


//*(X*l/isCM4C4*rl Czoct 


yL&<?*l / 






PAGENQ 


PAGE 000*1000 




KEY 1 


TASKIO 1 


REQUID 03 


TFIX 




CtvUX 






• PAGEHDL 


PAGE 000*1000 


FRAME 


00019000 KEY I 


TASKID 1 


REQUID 03 


TFIX 








^ PAGENQ 


PAGE 000*1800 




KEY 1 


TASKID 1 


REQUIO 03 


TFIX 


La* jtf 






PAGEHDL 


PAGE 000*1800 


FRAME 


00019800 KEY 1 


TASKID 1 


REQUIO 03 


TFIX 


oC&csvtto, <z*i / 


WOTrl*(&, 






• PAGENQ 


PAGE 000*2000 




KEY 1 


TASKID 1 


REQUID 03 


TFIX 




(7 






m PAGEHOL 


PAGE 000*2000 


FRAME 


0001A000 KEY 1 


TASKIO 1 


REQUID 03 


TFIX 










PAGENQ 


PAGE 000*2800 




KEY 1 


TASKID 1 


REQUID 03 


TFIX 










• PAGEHOL 


PAGE 000*2800 


FRAME 


00018000 KEY 1 


TASKID 1 


REQUID 03 


TFIX 










_ PAGENQ 


PAGE 00043000 




KEY 1 


TASKID 1 


REQUID 03 


TFIX 










PAGEHDL 


PAGE 000*3000 


FRAME 


00017800 KEY 1 


TASKID 1 


REQUID 03 


TFIX 










• PAGENQ 


PAGE 000*3800 




KEY 1 


TASKIO 1 


REQUIO 03 


TFIX 










A PAGEHDL 


PAGE 000*3800 


FRAME 


0001A800 KEY 1 


TASKID 1 


REQUID 03 


TFIX 










PAGENQ 


PAGE 000**000 




KEY 1 


TASKIO 1 


REQUIO 03 


TFIX 










• PAGEHDL 


PAGE 000**000 


FRAME 


OOO1B000 KEY 1 


TASKID 1 


REQUIO 03 


TFIX 










m TE PAGE 


ADDR 00050000 


TOD 


M1CSEC 2333011788*10161 


PSW AT TIME OF EVENT 


*7102000000*1632 INSTR 92FF20029*3F 








PAGENQ 


PAGE 00050000 




KEY 1 


TASKID 1 


REQUID 10 


TE 










• PAGEHDL 


PAGE 00050000 


FRAME 


0001B800 KEY 1 


TASKID 1 


REQUID 10 


TE 










— TE PAGE 


ADDR 0005FOOO 


TOD 


MICSEC 233301178862115* 


PSW AT TIME OF EVENT 


*7100000000*166E INSTR 07O6AO00A0O0 








PAGENQ 


PAGE OOO5F000 




KEY 1 


TASKID 1 


REQUIO 10 


TE 










• PAGEHDL 


PAGE 0005FOOO 


FRAME 


0001C000 KEY 1 


TASKID 1 


REQUIO 10 


TE 










^ TE PAGE 


ADDR 0005F800 


TOD 


MICSEC 2333011790227387 


PSW AT TIME OF EVENT 


*71D3000000*06** INSTR 0EEO05O1D6S6 








PAGENQ 


PAGE 0005F800 




KEY 1 


TASKID 1 


REQUID 10 


TE 










• PAGEHDL 


PAGE 0005F800 


FRAME 


0001C800 KEY 1 


TASKIO 1 


REQUID 10 


TE 










~ TE PAGE 


ADDR 00060000 


TOO 


MICSEC 23330117937706*1 


PSW AT TIME OF EVENT 


*71 03000000*06** INSTR 0EE0D501D686 








PAGENQ 


PAGE 00060000 




KEY 1 


TASKID 1 


REQUID 10 


TE 










• PAGEHDL 


PAGE 00060000 


FRAME 


OOOIDOOO KEY 1 


TASKID 1 


REQUID 10 


TE 










m TE PAGE 


ADDR 00060800 


TOD 


MICSEC 2333011796139258 


PSW AT TIME OF EVENT 


*71D3000000*06*4 INSTR 0EE0D501D686 








PAGENQ 


PAGE 00060800 




KEY 1 


TASKID 1 


REQUID 10 


TE 










• PAGEHDL 


PAGE 00060800 


FRAME 


00010800 KEY 1 


TASKIO 1 


REQUID 10 


TE 




Ce*z?ia-)\ 



























An example of SDAID page tracing during an assembly job. 





































EVENT ADDR OR PAGE ADDR 




EVENT MASKING 


















• 


K-CLASS *CODE 




PER 


LIMITS 


















EVENT-ID 


PSW 


TOD DEC MICSEC 


TE GPRS 


LONER 


UPPER 


GPR 13 


GPR 1* 


GPR 15 


GPR 


GPR 1 


GPR2 






A TE 


043000 


*7000000000*1C62 


2333035396598690 


Y 0000 


000000 


FFFFFF 


000*2888 


00000*AO 


00000760 


00000003 


00003FOC 


0000* IOC 






• TE 


050000 


*7 102000000* 1632 


2333035*16187226 


V 0000 


000000 


FFFFFF 


000402EO 


000*l*F8 


00060FFE 


800*193* 


00040C20 


0005D507 






TE 


O5FO0O 


*7100000000*166E 


2333035*16192369 


Y 0000 


000000 


FFFFFF 


000*02EO 


800*16*6 


0005F255 


800*193* 


00040C20 


00040A7F 






m. TE 


05F800 


*71D3000 000*06** 


2333035*17576315 


V 0000 


000000 


FFFFFF 


000*02EO 


0005F7FD 


00000019 


0005F255 


00000019 


000*0839 






• TE 


060000 


*71D3000000*06** 


2333035*20950387 


Y 0000 


000000 


FFFFFF 


000*02EO 


0005FFEA 


0000001F 


0005F255 


0000001F 


000*0B3F 






TE 


060800 


*71D3000000*06** 


2333035*231*6*1* 


V 0000 


000000 


FFFFFF 


000*0 2E0 


000607F* 


0000003F 


0005F255 


0000003F 


0005F289 






m. TE 


059800 


*7102000000*1E2C 


2333035**99**730 


Y 0000 


000000 


FFFFFF 


000*02EO 


000*OF58 


0005F255 


000*OA7C 


000598*1 


0000 1C7E 






• TE 


057800 


*71D2000000*1E6E 


2333035**99*9*77 


V 0000 


000000 


FFFFFF 


000*02EO 


00040F58 


0005F255 


00040A7C 


00001C7E 


00059B32 






TE 


05B800 


*7103000000*06** 


2333035*53007*49 


Y 0000 


000000 


FFFFFF 


000*02EO 


0005B7EE 


00000039 


0005D**7 


00000039 


00000004 






_ TE 


05C000 


*71D3000000*06** 


2333035*53671223 


Y 0000 


000000 


FFFFFF 


000*02EO 


0005BFF6 


00000021 


00050*47 


00000021 


00000005 






• TE 


05C800 


*7 103000000*06** 


2333035*5*0097*7 


Y 0000 


000000 


FFFFFF 


000*0 2E0 


0005C7CA 


000000*6 


0005D**7 


000000*6 


00000005 






TE 


050800 


*7102000000*10EE 


23330356232792*5 


Y 0000 


000000 


FFFFFF 


000*02EO 


800*108C 


000*1AF* 


00000002 


0000F50* 


00041B0* 






m. TE 


050000 


471D2000000410EE 


23330356233369*2 


Y 0000 


000000 


FFFFFF 


000*02EO 


800*108C 


00O*lAF* 


00000002 


OO00EDO3 


000*102 A 






• TE 


0*F800 


*71D2000000*10EE 


2333035623396991 


Y 0000 


000000 


FFFFFF 


000*0 2E0 


800*108C 


000*1AF* 


00000002 


0000E50A 


000*1E8* 






TE 


0*F000 


*71D2000000*10EE 


2333035623*80*01 


Y 0000 


000000 


FFFFFF 


000*O2E0 


800*108C 


000*1AF* 


00000002 


OOOOD006 


00041F0* 






_ TE 


04E800 


*7102000000*10EE 


2333035623538305 


Y 0000 


000000 


FFFFFF 


O0O*O2E0 


8004108C 


000*1AF* 


00000002 


OO0OD506 


000*2138 






• TE 


O*E0O0 


*71D2000000*10EE 


2333035623598321 


Y 0000 


000000 


FFFFFF 


000*02EO 


800*1080 


000*1AF* 


00000002 


OOOOCOO* 


000*2250 






TE 


0*0800 


*71D2000000*10EE 


2333035623656083 


Y 0000 


000000 


FFFFFF 


000*02EO 


800*108C 


00041AF* 


00000002 


O000C502 


000*2350 






_ TE 


0*0000 


*71D2000000*1**C 


233303562377*539 


Y 0000 


000000 


FFFFFF 


O00*O2E0 


800*1*1* 


000*1AF* 


00000002 


0000BD51 


000*2*56 






• TE 


060800 


*7102000000*22C8 


23330356670852*7 


Y 0000 


000000 


FFFFFF 


F60*1E28 


800*05A6 


900*17EC 


00000080 


00040B1A 


000*03F* 






TE 


0*2800 


*71D1000000*06EA 


2333035667090270 


Y 0000 


000000 


FFFFFF 


F00*OD78 


A00*112E 


800*1 1*C 


000*0078 


00040B1A 


00000001 






_ TE 


0*3000 


*70D0000000*1C62 


2333035783718692 


Y 0000 


000000 


FFFFFF 


000*2888 


00000*AO 


00000760 


00000003 


00003F0C 


0000*100 






• SDBUFFER END 




















(^KZiltj 



































A dump of the SD buffer after executing a page trace (TE) using the FASTREC 
output class. (The SD buffer is dumped on termination of SDAID). 



Serviceability Aids. 2.99 



Trace Routines 

SDAIDS 



























12334780B3CE 










_ IF GA 


000404 3C 


TOO 


«CSEC 2333012672382809 


PSW 


AT 


TIME 


OF 


EVENT 


471000000004043E 


INSTR 






BR IF 


0004043E 


TOO 


MlVsEC 2333012672458551 


PSM 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 








• IF C* 


00040448 


TOO 


MICiEC 2333012672534442 


PSW 


AT 


TIME 


OF 


EVENT 


471000OOOO04044A 


INSTR 


1 24447808 3DA 








_ BRIF 


ooo4044a\ 


TOO 


MICSiC 2333012672610919 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040454 


INSTR 


4780B30A0640 








IF GA 


00040454 \ 


I TOD 


MICSEft 2333012672685341 


PSW 


AT 


TIME 


OF 


EVENT 


4710200000040456 


INSTR 


12554780B3E6 








• IF 


00040456 


\oo 


MlCStCX 2333012672761969 


psw 


AT 


TIME 


OF 


EVENT 


471020000004 045A 


INSTR 


4780B3E60650 








_ IF GA 


0004045A 


TOD 


MICSEC V23330I2672838460 


psw 


AT 


TIME 


OF 


EVENT 


471020000004045C 


INSTR 


065047F0B3C2 








BRIF 


0004045C 


TOO* 


^UCSEC 1333012672913531 


psw 


AT 


TIME 


OF 


EVENT 


47102000000404SC 


INSTR 


47F0B3C21266 








• IF GA 


0004043C 


TOO 


WiCSEC 2\33012672990157 


psw 


AT 


TIME 


OF 


EVENT 


471000000004043E 


INSTR 


12334780B3CE 








m BRIF 


C004043E 


TOO 


MIOSEC 23*3012673065877 


psw 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 








IF GA 
• BRIF 
m IF GA 

IF 


00040448 
0004044a\ s 
01040454 
00040456 


TOO 
TOO 

TOO 


MICSEC 233B012673140296 
HICSeX 2331012673216921 
MICSEC \ 2 333B12673293403 
mK^EC \333dl2673368510 


psw 
psw 

PSw 
PSW 


AT 
AT 
AT 
AT 


TIME 
TIME 
TIME 
TIME 


OF 
OF 
OF 
OF 


EVENT 
EVENT 
EVENT 
EVENT 


471000000004044A 
4710000000040454 
4710200000040456 
471020000004045A 


INSTR 
INSTR 
INSTR 
INSTR 


12444780b3DA 


BZ CueAH S 

UTR 5, s 

ez cls.au (. 




l4780B3D«f0640 


[1255J4780B3E6 


|4780B3E«J0650 




• I F GA 


0104045A 


TOO 


MlCSeV 2\330l2673445O86 


PSw 


AT 


TIME 


OF 


EVENT 


4710200O0004045C 


INSTR 


|065C|47F0B3C2 


bc.TR £o 






^ BRIF 


0004045C 


TOO 


11 \ \ 1 ' 8 


PSW 


AT 


TIME 


OF 


EVENT 


471D20000004043C 


INSTR 


|47F0B3C2|1266 


CLf/lfi 1 






IF GA 
• BRIF 


00404 3C 
0004043E 


TOO 
TOO 




PSW 
PSW 


AT 
AT 


TIME 
TIME 


OF 
OF 


EVENT 
EVENT 


471000000004043E 
4710000000040448 


INSTR 
INSTR 


|1233|4780B3CE 


LTCL 3,3 
Sz CLEflRf 




(4780B3CEJ0630 




_ IF GA 


C0040443 


/^fno 


^-odto on 


PSW 


AT 


TIME 


OF 


EVENT 


471D00000004044A 


INSTR 


J1244^780B30A 


kTfl. <4-,(f. 






BRIF 


C004044AJ 


TOO 


MI / 19 


PSw 


AT 


TIME 


OF 


EVENT 


4710000000040454 


INSTR 


|4 780B30Al0640 


C>z ci-efiH. 5 






• IF GA 


01040454 


TOO 


hi /fa adt/m/) »i 


psw 


AT 


TIME 


OF 


EVENT 


4710200000040456 


INSTR 


12554780B3E6 






_ IF 


03040456 


no 


MI 52 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045A 


INSTR 


4780B3E60650 








IF GA 


0004045A 


TOO 


MI 31 
MI^.'t'/t' £&<&. 16 


PSw 


AT 


TIME 


OF 


EVENT 


471020000004045C 


INSTR 


065047F0B3C2 








• BRIF 


0004C45C 


TOO 


PSW 


AT 


TIME 


OF 


EVENT 


471D20000004O43C 


INSTR 


47F0B3C21266 








^ IF GA 


0O0404 3C 


TOO, 


PSw 


AT 


TIME 


OF 


EVENT 


471000000004043E 


INSTR 


12334780B3CE 








BRIF 


O004043E 


to/ 


"' 1SUL C/i f " 
MI... 96 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 








• I F r,n 


"0040448 


*Z D 


PSW 


AT 


TIME 


OF 
OF 


EVENT 
EVENT 


471D00000004044A 
4710000000040454 


INSTR 

INSTR 


12444780B3DA 
4780B3DA0640 






^ BRIF 


^v J 

0004044A) 


TOD 


MICSEC 2333012674430955 


PSw 


AT 


TIME 








IF 


00040454 


no 


MICSEC 2333012879517750 


PSW 


AT 


TIME 


OF 


EVENT 


4710200000040456 


INSTR 


12554780B3E6 










• IF 


TO040456 


TOD 


MICSEC 2333012879592055 


PSW 


AT 


TIME 


OF 


EVFNT 


471020000004045A 


INSTR 


4780B3E60650 










• IF 


0004045A 


TOO 


MICSEC 2333012879663631 


psw 


AT 


TIME 


OF 


EVENT 


471020000004045C 


INSTR 


065047FOB3C2 










BRIF 


0004045C 


TOO 


Mirsff 7111017879745185 
M ^<*^ ^/-/r ,57 


PSw 


AT 


TIME 


OF 


EVENT 


47I020000004043C 


INSTR 


47F0B3C21266 










• IF 


0O04043C 


TOO 


PSW 


AT 


TIME 


OF 


EVENT 


471000000004043E 


INSTR 


12334780B3CE 


& 








m 3RIF 


0004043E 


TOO 


psw 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 


tf/C 7" 






IF 

• BRIF 


00040448 
0004044A*) 


TOO 
TOO 


M = *>*M " Z 

, *c* 7 r. >51 


PSW 

psw 


AT 

AT 


TIME 
TIME 


OF 
OF 


EVENT 
EVENT 


471000000004044A 
4710000000040454 


INSTR 
INSTR 


12444780B30A 
4780B3DA0640 








m IF 


00040454 


TOO 


PSW 


AT 


TIME 


OF 


EVENT 


4710200000040456 


INSTR 


12554780B3E6 










IF 


00040456 


TOD 


psw 


AT 


TIME 


OF 


EVENT 


471020000004045A 


INSTR 


4780B3E60650 










• IF 


0004045A 


TOO 


" ■fouc&r' ! " 


psw 


AT 


TIME 


OF 


EVENT 


471020000004045C 


INSTR 


065047FOB3C2 










_ BRIF 


0004045C 


TOO 


MlCitL ^3J1U12080351883 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004043C 


INSTR 


47F0B3C21266 










IF 


000404 3C 


TOD 


MICSEC 2333012880427507 


PSW 


AT 


TIME 


OF 


EVENT 


471000000004043E 


INSTR 


12334780B3CE 










• BRIF 


0004043E 


TOD 


MICSEC 2333012880501878 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 




f (&3l HT) 



































This example shows an SDAID BR, IF and GA trace used to trace a loop using 
output class PSW. 

The GA trace was "taken off" by changing the contents of control register 9, and the 
programmers remarks on this example show how the information is interpreted. 



2.100 Serviceability Aids. 
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Library Display Programs and Utilities 
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Serviceability Aids. 2.101 



Library Display Programs and Utilities 

LSERV The label information cylinder is on the first full cylinder after the last system 

library on SYSRES. A display of all labels on the cylinder, with the exception of 
Data Set Secured labels, can be obtained by executing LSERV. Illustrations in this 
section show the location of the label information cylinder on SYSRES, and the 
layout of label information and record format. 

System requirements 

LSERV may be executed in any partition, with a minimum of 8192 bytes of the 
real or virtual address areas. LSERV assumes that the SYSRES label cylinder is 
formatted as described in DOS/ VS DASD Labels. 

Executing LSERV 

The control statements necessary to execute LSERV in a virtual partition are: 
From the console: 

// EXEC LSERV 
From the reader: 

// JOB jobname 
//EXEC LSERV 
/* 

/& 

LSERV can also be executed in a real partition. The output of LSERV shows the 
contents of the label cylinder on the device assigned to SYSRES. The output is 
directed to the device assigned to SYSLST. 

When and How to use 

1 . Operator action given in DOS/VS Messages indicates when LSERV must be 
executed. 

Programmer action, also given in DOS/ VS Messages, explains how to use the 

LSERV printout. 

For example, under the message: 

0P36NO REC FND 

2. It is useful to execute LSERV prior to running a program that is known to have 
been run sometime in the past, but whose workfile assignments and partition 
allocations are unknown. 

3. LSERV can be used for error analysis. LSERV displays the TLBL and the DLBL 
and EXTENT information contained on the SYSRES label cylinder. Information 
about secured data files is not displayed. 

Summary of information provided 

The printout of LSERV will show you the following details about the previous run: 

• Whether the correct DLBL/EXTENT information is still on the label cylinder 

• The permanent files 

• The temporary files 

• Extent type 

• File type. 

An example shown at the end of this chapter relates the data printed by the LSERV 
program to the DLBL/EXTENT job control statements. 



2.102 Serviceability Aids. 



The Label Information Cylinder 



Library Display Programs and Utilities 

LSERV 



The label information cylinder contains standard and user label information for 
background and foreground partitions. 

19 tracks on the 3330/3333, 12 on the 3340, or 20 on the 2314/2319 are allocated 
to the label information cylinder. 

The purpose of the label cylinder is to enable label information to be placed in the 
label save areas during program execution. 

Job control stores label information, which is contained in the input job stream, 
on the label cylinder. 

During program execution, label information on the label cylinder is used by the 
OPEN and CLOSE routines. 



SAMPLE JOB STREAM 

//JOB CATALOG USER PROGRAM 
// OPTION CATAL 

[Object module preceded "I 
by PHASE and INCLUDE] 



User 
Phase 



/• 

// LBLTYPNSD (01) 

//EXECLNKEDT 

/& 

// JOB EXECUTE USER PROGRAM 



//DLBL 

// EXTENT 

//DLBL 

// EXTENT 

//TLBL 

// ASSGN 

//ASSGN 

//ASSGN 

// EXEC USER 

/& 



File 1 (Seq. Disk) 



File 2 (Nonseq. Disk) 

File 3 (Labeled Tape) 
File 1 
File 2 
File 3 



Sequence of Events 

1 LBLTYP reserves label area in virtual storage 
for longest label block 

2 Link edit and catalog user phase to core 
image library 

3 Write label information to label cylinder 

4 Assign user files 

5 Bring program into virtual storage and process 
OPEN/CLOSE 

a. Bring label storage data into virtual storage 

b. Bring file labels into virtual storage 

c. Compare input, create new output labels 



An overview showing how DOS/VS uses 
the label information cylinder. 




SYSRES 



Label 

Information 

Cylinder 



Supervisor 



Seq. 
Disk 



Transient Area 



Label Area 
■** Nonseq. Disk and Tape 



Background Partition 
USER Program 

Open all 3 

Close all 3 



Virtual 
Storage 



Serviceability Aids. 2.103 



Library Display Programs and Utilities 

LSERV 



NO. 




nOMPOIMFNT 


STARTING DISK ADDRESS 


NUMBER 
OF TRACKS 
(Allocation) 


R = REQUIRED 




BB 


cc 


HH 


R 


= OPTIONAL 


1 


IPL Bootstrap Record 1 (SSASIPL1) 


00 


00 


00 


1 


1 


R 


IPL Bootstrap Record 2 (SSASIPLA) 


00 


00 


00 


2 


R 


Volume Label 


00 


00 


00 


3 


R 


User Volume Label 


00 


00 


00 


4 


O 


2 


System 
Directory 


Record 1 


00 


00 


00 


1 


1 


R 
R 
R 
R 


Record 2 


00 


00 


00 


2 


Record 3 


00 


00 


00 


3 


Record 4 


00 


00 


00 


4 


IPL Retrieval Program (SSASIPL2) 


00 


00 


01 


5 


R 


3 3 


Core Image Library Detector 


00 


00 


02 




* 


R 


4 


Core Image Library 


00 


End of CI Directory 




* 


R 


X | Y + 1 


5 


Relocatable Library Directory 


00 


End of CI Directory 




* 


O 


Z+1 


00 


6 


Relocatable Library 


00 


End of RL Directory 




* 


O 


X 


Y + 1 


7 


Source Statement Library Directory 


00 


End of RL Directory 




. * 


O 


Z + 1 


00 


8 


Source Statement Library 


00 


End of SS Directory 




# 


O 


X 


Y + 1 


9 


Procedure Library Directory 


00 


End of SS Directory 




# 


O 


Z + 1 | 00 


10 


Procedure Library 


00 


End of PL Directory 




# 


O 


X 


Y + 1 


11 




00 


End of P Library 




* 


O 


Label Information Cylinder 


Z + 1 


00 



* Allocation Dependent On User Requirements 
X = Ending CC of the Preceeding Directory 
Y = Ending HH of the Preceeding Directory 
Z = Ending CC of the Preceeding Library 

The location of the label information cylinder on the SYSRES extent 



2.104 Serviceability Aids. 



Library Display Programs and Utilities 



DISK PACK TYPE 



TRACK ALLOCATION 
for a 1 , or 2, or 3, partition system. 
(First Full Cylinder after Last Library on SYSRES) 
Track 

Temporary 



LSERV 



For a 1 partition system, information on 
tracks 2, 3, 4 and 5 is ignored, and for 
a 2 partition system the tracks for the 
F1 partition follows BG and information 
on tracks 4 and 5 is ignored 



3340 



2314 

or 
2319 



3330 

or 

3333 




1 
2 
3 
4 
L5 



| BG 


(USRLABEL) * | 


| BG 


(PARSTD) | 


I F2 


(USRLABEL) * | 


I F2 


(PARSTD) | 




I F1 


(USRLABEL) * | 


1 F1 


(PARSTD) | 



6 I (STD LABEL) 

• iz: 



Standard (Permanent) 

Temporary 

Standard (Permanent) 

Temporary 

Standard (Permanent) 



7 [^ Standard Labels | 

I — for all 1 

I — Partitions 1 



10 
11 



12 
13 
14 
15 
16 
17 
18 



Additional Standard Labels 



19 




^Standard (Permanent) 



U J 



TRACK ALLOCATION 
for a 4 partition system 

Track 



TRACK ALLOCATION 
for a 5 partition system 



o|_ 


BG (USRLABEL) 


* 


1 C 


BG (PARSTD) 




2C 


F3 (USRLABEL) 


* 


3 


F3 (PARSTD) 




4 r 


F2 (USRLABEL) 


* 




5| 


F2 (PARSTD) 






6L 


F1 (USRLABEL) 


* i 


7 


F1 (PARSTD) 




«c 


Standard for all 




9C 


Partitions 




10 1 j 


11 | 


12 | 


13L_ 


14^ 


dditional Standard Labels^ 


1B| 


16 


"I I 


IS | ] 


19 



Temporary 
Standard (Permanent) 
Temporary 
Standard (Permanent) 
Temporary 
Standard (Permanent) 
Temporary 
Standard (Permanent) 



Track 






BG 


(USRLABEL) 


* I 


1 


BG 


(PARSTD) 




2 


F4 


(USRLABEL) 


* | 






3 


F4 


(PARSTD) 








4 


F3 


(USRLABEL) 


•I 


5 


F3 


(PARSTD) 








6 


F2 


(USRLABEL) 


* I 


7 


F2 


(PARSTD) 




8 


F1 


(USRLABEL) 




9 


F1 


(PARSTD) 


I 


10 




11 




12 


I 


13 




14 


Additi 


onal Standard Labels] 


15 








16 


I 


17 


I 


18 




19 





Temporary 

Standard (Permanent) 

Temporary 

Standard (Permanent) 

Temporary 

Standard (Permanent) 

Temporary 

Standard (Permanent) 

Temporary 

Standard (Permanent) 



> Standard (Permanent) 



* Label sets submitted in a job stream 
without a // OPTION PARSTD,STDLABEL 
are written to the temporary area for the 
partition being used. 



Track allocations of the Label Information Cylinder for a 1, 2, 3, 4, and 5 partition system. 



Serviceability Aids. 2.105 



Library Display Programs and Utilities 

LSERV 



Job Control Statements or Operator Initiation Commands 



//VOL 



and 



> 



//TPLAB 



//TLBL 



Label 

Information 

Cylinder 




r~ 



r~ 



//VOL 



r 



//TLBL 



//TPLAB 



~~N 



A 



Reserved 
Byte 


Filename 


Auxiliary 
Byte 


File 
ID 


File 

Serial 

Number 


Volume 

Sequence 

Number 


File 

Sequence 

Number 


Generation 
Number 


Version 
Number 


Creation 
Date 


Expiration 
Date 


Fire 

Security 

Number 


Block 
Count 


System 
Code 


Flag 
Bytes 


1 


7 


1 


17 


6 


4 


4 


4 


2 


6 


6 


1 


6 


13 


2 


C 

i 


) > 


i 


1 
Bvte Count 


8 


9 


26 


32 


36 


40 


44 


46 


52 


58 


59 


65 


78 



Displacement in virtual storage 



Format and contents of the label information cylinder for tape labels 

(Shaded areas are not processed by DOS/VS Logical IOCS) 



2.106 Serviceability Aids. 



Library Display Programs and Utilities 



1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 


12 


131415 


16 


17 


18 




19 


Field 


1- 

UJ 

\- 
X L 

UJ O 

CQ.2 
_IT3 
OS 


Filename 


x: 
o 

i 
< 

co 

< 


File ID 


Q 

b 

LL 


File 

Serial 

Number 


6 
z 

cr 

CD 
CO 

CD 

E 

D 
O 
> 


CD 
•w 
CD 

Q 

c 
g 

CO 
CD 

6 


<D 
4-< 
CO 

Q 

c 
o 

CO 

'5. 

X 

UJ 


■D 

> 

CD 
</> 

CD 


CD 

•D 

8 

c 

CD 

a 
O 


System 
Code 


Volume 

Serial 

Number 


CD 

a 
> 

t- 

c 

CD 
>< 
UJ 


o" 
z 

& 

CD 
CO 

+-< 

c 

CD 
4-» 

X 

UJ 


Extent 
Lower 
Limit 


Extent 
Upper 
Limit 


o 

-Q </> 
c </> 

*- CD 
CO "O 

=r xj 
8< 

55 


<3 

i 

CN 
CO 
CN 


1 

CD 

a 
a 
D 

CM 
CO 
CM 


Another 
Extent if 
DAM, 
ISAM or 
VSAM 


1 


7 


1 


44 


1 


6 


2 


3 


3 


2 


1 


13 


6 


1 


1 


4 


4 


2 


1 


1 


Bytes 


o 


T ~ 


00 


OJ 


CO 
IT) 


in 


o 


CM 

CO 


UJ 

to 


s 


o 
r^ 


r^ 


CO 


o 


SJ 


CM 
OJ 


CO 

en 


o 
o 


CM 
O 


CO 

o 


Displacement 



LSERV 



Field 



Name 



1. DLBL-EXTENT 



Description 

SAM 

Bit 0:1= Next extent on a new pack. 

Bit 1 : 1 = Last extent. 

Bit 2: 1 = Bypass extent. 

Bit 3: 1 = New volume on same unit. 

Bit 4: 1 = Extent limits omitted. 

Bit 5: 1 = Extent converted to DASD 
address. 

Bit 6: 1 = No EXTENT /XTENT card. 

Bit 7: 1 = Unused. 
DAM, ISAM, or VSAM 

Number of extents. 



Field 



Name 



12. System Code 



Description 

Initialized to contain one character 
string IBMDOSVS. This field is not 
processed by DOS/VS. 



1 3. Volume Serial No. Volume serial number for extent. 



14. Extent Type 



2. 


Filename 




3. 


DAM/ISAM Switch 


Bits 0-3: Unused. 

Bit 4: 1 = Extent limits omitted. 

Bit 5: 1 = Extent converted to DASD 

address. 
Bits 6 &7: Unused. 



File ID 



5. Format ID 

6. File Serial No. 

7. Volume Seq. No. 

8. Creation Date 

9. Expiration Date 

10. Reserved 

1 1 . Open Code 



File identifier including generation 
and version numbers. If field is 
missing on DLBL card, Filename 
padded with blanks is inserted. 
This field is not used when a 
VSAM data space or Unique file 
is defined. Also, filename is not 
substituted for file-l-D with 
VSAM 

Numeric 1 is inserted. 

Volume serial number from first 
extent. 

Always initialized to X'OOOT. 

Initialized with 3 bytes of X'00'. 

If date is in the form YYDDD, it is 
converted to YDD. If date is in re- 
tention period form, 1 to 4 characters, 
the field is padded with binary zeros. 

The retention period, if specified is 
converted to a 2-byte number and 
inserted in this field. 

DLBL type: 

S= SAM 

D= DAM 

A= VSAM 

C or E = ISAM System where: 

C = Load create function 

E = Load extend function 



15. Extent Seq. No. 



16. 
& 
17. 



Extent Lower 
and Upper 
Limits 



18. 



Logical (Symbolic) 
Unit Address 



19. 



2321 Lower Cell 
2321 Upper Cell 



Same codes as in Format-1 label: 
X'00' = Next three fields do not 

indicate any extent. 
X'01 ' = Prime data area ISAM, data 
area (SAM, DAM) or data 
space (VSAM), (that is the 
extent containing the user's 
data records). 

X'02' = Overflow area of an ISAM 

file. 
X'04' = Cylinder index or master 

index of an ISAM file. 
X'40' = User label track area. 
X'8n' = Shared cylinder indicator, 

where n = 1,2, or 4. 

Number of extent as determined by 
the extent card sequence. 

Before the OPEN, DLBL/EXTENT 
information is in the relative track 
form of HHNNT followed by three 
bytes of binary zeros. 
HH = Relative (to 0) start address in 

tracks. 
NN = Number of tracks. 
T = or upper track number for 

split cylinder in SAM files. 
Following an OPEN on DLBL/ 
EXTENT cards, or whenever DLAB/ 
XTENT cards are used, the extent 
lower and upper limits are each in the 
CCHH format. 

This 2-byte field identifies the logical 
unit with the same code as that used 
in a CCB. The first byte identifies the 
unit class: 

X'00' = System Logical Unit 
X'01' = Programmer Logical Unit 
The second byte identifies the logical 
unit within its class. 

Thus X'0003' denotes SYSLST and 
X'01 03' denotes SYS003. 

2321 extent lower and upper cell 
limit. This 2-byte field contains zeros 
for disk devices. 



NOTE: For SAM files, a complete 104-byte block is repeated for each new EXTENT. 

For DAM, VSAM, and ISAM files, only fields 1 3 through 1 8 are repeated for each EXTENT. 

Format and contents of the label information cylinder for DASD and DISKETTE labels. 
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Library Display Programs and Utilities 

LSERV 




An example of some of the output to a line printer after executing the LSERV program, part 1 
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Library Display Programs and Utilities 

LSERV 



EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 

EXTENT TYPE 

EXTENT LIMITS OMITTED 

SYMBOLIC UNIT 

VOLUME SERIAL NUMBER 












00 

1 (PRIME DATA) 

SYSROR CCB FORMAT 0000 
OMITTED 




Fl USER LABELS (TEMPORARY PER PARTITION! 


TRACK 


8 








NONE 
















Fl PARTITION STANDARD LABELS IPERMANENT) 


TRACK 


9 








IJSYSIN 

FILE IDENTIFIER 
FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 
CREATION DATE 
RETENTION PERIOD (DAYS) 
FILE TYPE 












SYSROR10 

OMITTED 

01 

OMITTED 

0007 

SEQUENTIAL 




EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 
EXTENT TYPE 
EXTENT LIMITS OMITTED 
SYMBOLIC UNIT 
VOLUME SERIAL NUMBER 












00 

1 (PRIME DATA) 

SYSROR CCB FORMAT 0000 
OMITTED 




STANDARD LABELS (ALL PARTITIONS-PERMANENT I 


TRACKS 


10-19 FOR 2314,10-18 FOR 3330, OR 10-11 FOR 33*0 




IJSYSRS 

FILE IDENTIFIER 
FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 
CREATION DATE 
EXPIRATION OATE 
FILE TYPE 












DOS.SYSRES.FILE 

11UU 

01 

OMITTED 

99/365 

SEQUENTIAL 




EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 

EXTENT TYPE 

RELATIVE (TO ZERO) START 

NUMBER OF TRACKS 

SYMBOLIC UNIT 

VOLUME SERIAL NUMBER 


ADDRESS 


IN 


TRACKS 


01 

1 (PRIME DATA) 

0001 

3959 

SYSRES CCB FORMAT 0006 

111111 




IJSYSLN 

FILE IDENTIFIER 












DOS.WORKFILE.NO.O _ 


,(4x 33* *r) _[ 




FILE IDENTIFIER 
FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 
CREATION OATE 
EXPIRATION OATE 
FILE TYPE 



DOS LABEL CYLINDER DISPLAY 



COMPARE-FILE FOR TESTCASE0UTPU1 

TESTV1 

01 

OMITTED 

69/001 

DIRECT ACCESS 



EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 

EXTENT TYPE 

RELATIVE (TO ZERO) START ADDRESS IN TRACKS 

NUMBER OF TRACKS 

SYMBOLIC UNIT 

VOLUME SERIAL NUMBER 



FILE IDENTIFIER 
FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 
CREATION DATE 
EXPIRATION DATE 
FILE TYPE 

EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 

EXTENT TYPE 

RELATIVF (TO ZERO) START ADDRESS IN TRACKS 

NUMBER OF TRACKS 

SYMBOLIC UNIT 

VOLUME SERIAL NUMBER 



00 

1 (PRIME DATA) 

0006 

387* 

SYS005 CCB FORMAT 

TESTV1 



WORK FILE FOR SLIB 

TESTV1 

01 

OMITTED 

69/001 

DIRECT ACCESS 



00 

1 (PRIME DATA) 

3880 

0100 

SYS010 CCB FORMAT 

TESTV1 



END OF LABEL CYLINOER DISPLAY 



(£x338*r) 



An example of some of the output to a line printer after executing the LSERV program, part 2. 
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Library Display Programs and Utilities 
LSERV 



// DL6L filename, 'file ID', date, codes, data security 

// EXTENT symbolic unit, serial number, type, sequence number, relative track, number of tracks, split cylinder track, B bins 



// DLBL IJSYSRS/DOS.RECORDER.FILE',99/365,SD 
// EXTENT SYSRES, 111111.1,1,3960,20,, 



May also be printed as 
RETENTION PERIOD (DAYS) 
Depends on the manner used to 
specify date in the DLBL 
statement. 




JOB CONTROL statements, 

for details see DOS/VS System Control Statements 



DOS LABEL CYLINDER DISPLAY 



FILE SERIAL NUMBER 




mm 


VOLUHE SEQUENCE NUMBER 




01 


CREATION DATE 




OMITTED 


EXPIRATION DATE 




99/365 


FILE TYPE 




SEQUENTIAL 


EXTENT INFORMATION 






EXTENT SEQUENCE NUMBER 




01 


EXTENT TYPE 




1 (PRIME DATA) 


RELATIVE ITO ZEROI START ADDRESS 


IN TRACKS 


3880 


NUMBER OF TRACKS 




0060 


SYMBOLIC UNIT 




SYS004 CCB FORMAT 


VOLUME SERIAL NUMBER 




111111 


SYSRC 

FILE IDENTIFIER 




'DOS. RECORDER. FILE 


FILE SERIAL NUMBER 




111111 


VOLUME SEQUENCE NUMBER 




01 


s: f CREATION DATE 
\ EXPIRATION DATE 




OMITTED 




99/365 


FILE TYPE 




^SEQUENTIAL 


EXTENT INFORMATION 






EXTENT SEQUENCE NUMBER 




foi 


EXTENT TYPE 




1 (PRIME DATA) 


EXTENT LONER LIMIT 




CYLINDER 198 
HEAD 00 


EXTENT UPPER LIMIT 




CYLINDER 198 
HEAD 19 


SYMBOLIC UNIT 




SYSREC CCB FORMAT 


VOLUME SERIAL NUMBER 




^111111 


RECT 






FILE IDENTIFIER 




NAME-LIST 


FILE SERIAL NUMBER 




HELPfl 


VOLUME SEQUENCE NUMBER 




01 


CREATION OATE 




OMITTED 


EXPIRATION DATE 




69/001 


FILE TYPE 




DIRECT ACCESS 


EXTENT INFORMATION 






EXTENT SEQUENCE NUMBER 




00 


EXTENT TYPE 




1 (PRIME DATA) 


RELATIVE (TO ZERO) START ADDRESS 


IN TRACKS 


0020 


NUMBER OF TRACKS 




0003 


SYMBOLIC UNIT 




SYS005 CCB FORMAT 


VOLUME SERIAL NUMBER 




HELPfl 



£f*?M5 



Relationship between DLBL/EXTENT card data and the information printed by the LSERV program. 
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Under certain circumstances knowing the contents of libraries can be helpful 
during program debugging. The library display programs DSERV, CSERV, PSERV, 
SSERV, and RSERV enable you to print an image of: 

• Any library directory 

• Any library 

• Any program in any library 

• Any phase in any library. 

When using DSERV, a System Status Report is always printed before the specified 
directory. A private status report is also printed when private libraries are used 
with the system. 

An example of a system status report is shown in two examples at the end of the 
section describing the Linkage Editor Map (E-4 of this manual). 



When and how to use 

Control statements required to execute the library display programs are shown in 
the next two tables. 

The following list gives some examples of when to use the various library display 
programs: 

1. The operator action given under the appropriate message in DOS '/VS Messages 
indicate when to execute DSERV. 

For example, under the message: 
1C33A PROGRAM NOT FOUND 

When error message instructions include a library display, enter cards that 
correspond to the library and type of display. Be sure to substitute the actual 
program module, book, sublibrary or phase name for the words phase 1, module 1, 
book 1 , sublib 1 , or prog 1 . 

Note: If you assign a private library and display that type of library, only the private 
library will be displayed. To obtain a display of the system library, the private 
library must be unassigned. 

Additional information on the display program is found in DOS/VS System 
Control Statements. 

Further recommendations as to when to use the library display programs are given 
after the two tables following. 



Library Display Programs and Utilities 

LIBRARY DISPLAY 
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Library Display Programs and Utilities 

LIBRARY 
DISPLAY 



Control cards required to execute the Library display programs 



Unit 


Element 


Control Statements Required 


Core Image 
Library 


Phase 


// JOB jobname 
//EXECCSERV 

DSPLY phasel [,phase2,...] 

/* 
/& 


Program 


// JOB jobname 
//EXECCSERV 

DSPLY prog1.ALL[,prog2.ALL,...] 

/* 
/& 


Library 


// JOB jobname 
//EXECCSERV 
DSPLY ALL 

/* 
/& 


Directory 


Unsorted 
// JOB jobname 
//EXEC DSERV 

DSPLY CD 
/* 
/& 


Sorted 
// JOB jobname 
// EXEC DSERV 

DSPLYSCD 

/* 
/& 


Relocatable 
Library 


Module 


// JOB jobname 
// EXEC RSERV 

DSPLY modulel [,module2,...j 

/* 

/& 


Program 


// JOB jobname 
// EXEC RSERV 

DSPLY prog1.ALL[,prog2.ALL,...] 

/* 
/& 


Library 


// JOB jobname 
// EXEC RSERV 
DSPLY ALL 

/* 

/& 


Directory 


Unsorted 
// JOB jobname 
// EXEC DSERV 

DSPLY RD 
/* 
/& 


Sorted 
// JOB jobname 
// EXEC DSERV 

DSPLY RD 

/* 
/& 



Table C-2 Library Display Control Cards (Part 1 or 2) 

Note: To execute DSER V, SYSIN must be assigned to a card reader, a tape unit, or a disk drive. 
SYSLOG must be assigned to a 1052, 3210 or 3215 console printer, or for the Model 125 
it must be assigned to the CRT. 
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Library Display Programs and Utilities 

LIBRARY 
DISPLAY 



Unit 


Element 


Control Statements Required 


Source 

Statement 

Library 


Book 


// JOB jobname 
//EXECSSERV 

DSPLY sublib.bookl [,sublib.book2,...] 

/* 

/& 


Sub- 
library 


// JOB jobname 
// EXECSSERV 

DSPLY sublib1.ALL[,sublib2.ALL,...] 

/* 

/& 


Library 


// JOB jobname 
// EXECSSERV 
DSPLY ALL 

/* 

/& 


Directory 


Un sorted 
//JOB jobname 
// EXECDSERV 

DSPLY SD 
/* 
/& 


Sorted 
//JOB name 
// EXEC DSERV 

DSPLYSSD 
/* 
/& 


Procedure Library 


Directory 


Unsorted 
// JOB name 
// EXEC DSERV. 
DSPLY PD 

/* 
/& 


Sorted 
//JOB name 

//EXECDSERV 

DSPLYSPD 
/* 
/& 


Library 


// JOB jobname 
//EXECPSERV 
DSPLY ALL 

/* 

/& 


Procedure 


// JOB jobname 
//EXECPSERV 

DSPLY procedural [,procedure2,..] 


Directories 


All 


Sorted 
// JOB name 
// EXEC DSERV 

DSPLY ALL 
/• 
/& 


Sorted 
// JOB jobname 

// EXEC DSERV 
DSPLYSALL 

/* 
/& 


Systems 
Directory 




// JOB jobname 

// EXEC DSERV 

DSPLY SD 

/* 

/& 




Table C-2 Library Display Control Cards (Part 2 of 2) 
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Library Display Programs and Utilities 

LIBRARY DISPLAY 2. Execute DSERV when you require details about the core image library. 



• 


SYSTEM CORE IMAGE DIRECT 


















05/73 PAGE 10 


















• 


PHASE 


DISK 




TXT 


BTS 1ST 


RLD 


RLD 


LOAD 


ENTRY 


PART ENTRY 


SVA 


IN 






NAME 


ADDR 




RCOS 


TXT RCD 


RCDS 


ITEMS 


ADDR 


ADDR 


AODR ADDR 


ELIG 


SDL 




• 
m 




yp 


Sr 

R 




DEC 











HEX 











SSRAST13 


005 


00 


02 


001 


0582 






000000 


000000 












SIJKSOO 


033 


06 


04 


001 


0536 






oooo oo 


000000 










• 


«IJKS10 


033 


06 


05 


001 


0284 






000000 


000000 










SIJKS20 


033 


06 


06 


001 


0488 






000000 


000000 












61 JKS30 


033 


07 


01 


001 


0592 






000000 


000000 










• 


CIJKS40 


033 


07 


02 


001 


0392 






000000 


000000 










SI JKS50 


033 


07 


03 


001 


0360 






000000 


000000 












6IJKS60 


033 


07 


04 


001 


0672 






000000 


000000 













SIJKS70 


033 


07 


05 


001 


0584 






000000 


000000 










SIPLRT2 


005 


02 


06 


006 


0072 






000000 


0OOC68 












£IPLRT3 


005 


03 


06 


003 


0248 






000C68 


OO0C68 










• 


SIPIRT4 


005 


04 


03 


006 


0416 






O0OC68 


0OOC68 










SIPLRT5 


005 


05 


03 


005 


0240 






00OC68 


000C68 


/-* 










EJOBACCT 


005 


09 


03 


001 


0002 






000000 


000000 


^s 








9 


SJ06CTLA 


000 


17 


03 


009 


0720 






000000 


001810 


^-^ 








6J0BCTLB 


000 


18 


06 


004 


0340 






001810 


001810 


y 










CJOBCTLD 


000 


19 


04 


Oil 


05 04 






001810 


001810 










9 


SJ08CTLE 


001 


01 


03 


007 


0610 






001810 


001810 










6J08CTLF 


001 


02 


04 


006 


0444 






001810 


001810 












6J06CTLG 


001 


03 


04 


006 


0148 






001810 


001810 










9 


6JOBCTLJ 


001 


04 


04 


008 


0208 






001810 


001810 










SJOBCTLK 


001 


05 


06 


005 


0972 






001810 


001810 












SJQBCTLM 


001 


06 


05 


007 


0136 






000000 


oooooo 










9 


EJOBCTLN 


001 


07 


06 


001 


0784 






001810 


ooiaio 










6LIBSTAT 


005 


02 


01 


004 


0984 


001 


00011 


040800 


040800 


040078 


YES 






a 


SLNKEDT 


005 


06 


02 


019 


0491 






000000 


003EC8 










a 9 


SMAINDIR 


005 


00 


03 


010 


0976 


000 


00011 


040800 


040800 


040078 


YES 






ALI ST 


010 


12 


05 


012 


06 28 


001 


00100 


04 0078 


040300 


040078 










ALTDC 


010 


08 


03 


004 


0700 


000 


00053 


040078 


04031A 


040078 






£* %5/<A 



PHASE NAME 



The names of programs (phases) 



DISK ADDR 



The disk address of the phase on the core image library (Disk address of first text, TXT, record) 



TST RCDS 



The number of records belonging to the phase (Number of TXT records) 



BTS LST 
TXT RCD 



The number of TXT bytes in the last TXT record 



RLD RCDS 
(see note 1 ) 



The number of additional relocation list dictionary (RLD) records, referring to the address constants in the text 
that will be modified by the relocating loader 



RLD ITEMS 
(see note 1 ) 



Total number of RLD items that show the total number of TXT modifications due to relocating load 



VER MOD 
LEV LEV 
(see note 2) 



The version and modification level of phases, modules, and books in the core image, relocatable, and source 
statement libraries respectively. 



LOAD ADDR 



The load address of the phase at the time it is link-edited to core image library (Link-edit time) 



ENTRY ADDR 



Entry address of the phase at link-edit time 



PART ADDR 
(see note 1 ) 



Start address at link-edit time of the partition to which the phase is link-edited 



ENTRY ADDR 



The entry address in the SVA of the phase contained in the SVA. (These phases can be loaded into the SVA after 
IPL or by cataloging them into the SVA during system operation.) 



SVA ELIG 



A YES in this column indicates that it is permissible to load the phase in the SVA either after IPL time or during 
system operation using the linkage editor. 

(It indicates that the phase is reentreable and relocatable which it must be to enable its use by the system when it 
resides in the SVA.) 



IN SDL 



A YES in this column indicates that the name of the phase is in the SDL. 

Note: A phase name can be present in the SDL but need not necessarily be present in the system core image 

library. 



Notes 1. Entries are printed in these columns only when a relocatable phase is found in the library. 

2. Version and modification levels are always listed for modules and books displayed, but are listed for phases 
only when displaying a specific phase. This information is required under some conditions of system mal- 
functions that may be caused by the use of programs at different levels of modification. 

Most IBM-supplied programs have a 2-byte VM (version and modification level) number. The number may be 
in decimal or hexadecimal form in a storage dump, depending on the input format. It is in decimal form in a 
DSERV printout of the source statement or relocatable library. For example, version 5 modification level 
appears at 2800 or F2F8 in a storage dump and a 5.0 in a DSERV printout. The VMs for phases and transients 
are contained within the phase or transient. 

Your IBM CE/FE can also check your library by using DSER V to examine it for the applicability of an IBM- 
supplied program temporary fix (PTF). 

The modification level of your library is also required if an authorized program analysis report (APAR) must 
be submitted to IBM for analysis of a particularly difficult programming error. 
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Similar information is displayed by the DSERV program for the following 
directories: 

• Transient 

• Relocatable 

• Source statement 

• Procedure. 

3. Use CSERV to display a phase and compare it with the program listings for the 
phase when, for example, a program using that phase produces incorrect results 
after having run successfully in the past. RLD information for any relocatable 
phases will also be displayed. 

4. Use PSERV to check job streams cataloged in the procedure library if they are 
suspected of causing program errors. Before modifying any job stream on this 
library, use PSERV to enable checks to be carried out on the modifications. This 
helps to reduce errors when using the overwrite function of the catalog procedure. 

Note: The procedure library itself can be used as a secondary debugging aid. It is 
useful to catalog job streams that initiate or execute the more frequently used 
debugging aids, or aids requiring complex job streams. For example, time will be 
saved if EREP or trace routine job streams are kept on the procedure library. 

5. Use RSERV when, for example, a modification must be made (via REP cards) 
to an object module in the relocatable library. 

An example of an RSERV output is shown below: 



Library Display Programs and Utilities 

LIBRARY DISPLAY 






POAIOGTW V.M 


29.0 






00004 BLOCKS 


SYSTEM i 


RELOCATABLE LIBRARY 








• 


PHASE PDAIOGTK, 


,+0.N0AUT0 
























ESQ 




016 


0001 




PC 000060 00017C 














TXT 


000060 


136 


0001 


07FA070A 


07FA070A 


47F09120 


42C0910B 


58C0006O 


9500C045 


4770909A 


9500910B 




• 










078A9500 


910B078A 


9500910B 


078A95 00 


910B078A 


95009108 


078A9078 


910C4700 












90CA4180 


903B4170 


000695FF 


80004780 


90CA0500 


8000C08B 


478090C0 


468090C6 














9878910C 


07FA4670 


90AA5870 


91180207 


70000020 


90017008 


D200700C 


008B5880 




6 










00144880 


805A4A80 
















TXT 


0000E8 


040 


0001 


910A02O1 


70108002 


41770012 


5970911C 


47409100 


58 709114 


50709118 


9878910C 














07FA0OOO 


00000012 
















• 


TXT 


000114 


136 


0001 


00000000 


00000000 


00000000 


92009069 


D200 907D 


9048D200 


90839049 


D2009089 












904AD200 


908F904B 


D2009095 


904C95FF 


903B4770 


915492F0 


909F47F0 


91709OCA 














9180905B 


47109170 


02019080 


90BAD201 


90BA9152 


927090BD 


928090C7 


95009070 




• 










4770917E 


D201907A 


91 DA 90 57 


912095FF 


903:4780 


91C05850 


903C5860 


9O40D2O3 












90549040 


1B651876 


















TXT 


00019C 


064 


0001 


1B665060 


910C4C70 


910E4B70 


910E1A75 


50509114 


50509118 


507091 1C 


98579120 




• 










47F091CC 


41509120 


58690000 


47F09198 


58B09114 


D711B003 


B00047F0 


906CA000 




END 


404040 






















(fxjt/rrn 



6. Use SSERV to examine the contents of a book. Use it, for example, to check if 
changes are required to privately written macros cataloged into the source 
statement library, in unedited macro format. 
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Library Display Programs and Utilities 

ESERV 



This service program de-edits macros contained in the source statement library. 
When the source macro definition is not available, ESERV enables you to de-edit 
the edited macro to source format. Several macros can be de-edited at one time. 
ESERV also combines the function of de-editing with that of updating the source 
macro definition. 

The ESERV program allows you to: 

• De-edit and update a macro definition 

• Obtain a printout of the de-edited macro definition 

• Obtain a printout and a punched card deck of the de-edited macro definitions 

• Verify and update statements from a printout of the source macro definition. 

For a detailed description of the control statements used by this program, refer to 
the Guide to the DOS/ VS Assembler. 

Input consists of ESERV control statements entered via SYSIPT, and the edited 
macro definition in the macro library. 

Output consists of: 

• The selected macro definitions in source format (and updated) on the device 
assigned to SYSPCH and/or the device assigned to SYSLST. 

Note: To allow immediate editing of the updated macro, an END card can be 
generated at the end of the update run. 

• Update information 

• Error diagnostics. 

The illustration opposite shows the input and output of the ESERV program, and 
includes a list of control statements for the program. 



How to use 

Six control statements are available to update the de-edited source macro definitions. 
These are described in the table below: 



COL: 


for specifying the columns containing the sequence numbers in the statements of a macro definition 


ADD: 


for adding source statements to a macro definition 


VER: 


for verifying the contents of a specific source statement of a macro definition 


DEL: 


for deleting source statements from a macro definition 


REP: 


for replacing source statements in a macro definition 


RST: 


for specifying a new number sequence 


END: 


for indicating the end of an update to a macro definition. 


Note: Each update control statement is printed on SYSLST followed by (except for RST) the affected source statement. This printout 
is known as the update survey. For ADD, the de-edited source record preceding the records to be added is printed, followed by the 
added records. For VER, the character string to be compared is printed, followed by the de-edited source record to be verified. For 
DEL, the de-edited source records to be deleted are printed. For REP, the de-edited source records to be replaced are printed, followed 
by the records to be inserted. 



Errors During Update 

If an error is detected during updating, a message is printed on the update survey. 
The requested update action will not be performed. If possible, updating will 
continue with the next update control card. Otherwise, a termination message is 
given and only the remaining update control cards are printed on the survey. 
De-editing of the macro will always be completed. Th e job will be cancelled at the 
end of the ESERV run; that is, remaining jobsteps to edit the macro and catalog 
the EDECK again will not be executed. 
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Updating will continife with the next update control card for all errors except when: 

• The COL statement has invalid operands. 

• COL statement is not the first update control statement. 

• The macro is completely de-edited without all update control statements 
being completely processed. 

• An RST statement has an invalid operand. 

Appendix D shows two ESERV job stream examples. 
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ESERV 




macro source 
deck 




SYSIPT 



SYSPCH 




PROCESSING 



ESERV 




SYS001/2 

This illustrates the input to and output from the ESERV 



SYSLST 



When to use 

• Use ESERV to punch up a new card deck. 

• ESERV can be used to list the source code of an edited macro. 

• If an IBM program tempory fix (PTF) is to be installed in your library, use 
ESERV to de-edit and update the macro. An example of installing a PTF 
using ESERV is given in appendix D. 

Note: Before installing a PTF use either ESERV or SSER V to display the macro in 
order to check if the PTF is applicable. 
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LVTOC 



The LVTOC program enables you to print out VTOC (volume table of contents) of 
a DASD disc pack. 

From the printout (the VTOC display), you can see the names of files, contained 
on any disc pack, their extents, and addresses. A VTOC display, therefore, enables 
you to keep track of data sets and files on all your packs. 

Additional information on the VTOC display program can be obtained from 
DOS I VS System Control Statements 



Information in the VTOC 

All standard file labels are grouped together and stored in a specific area on a disk 
pack or data cell. This group of labels essentially a directory of all data records on 
the volume because each file label contains file limits. Therefore, this group of 
labels is called the volume table of contents, or VTOC. Because the VTOC itself 
is a file of records containing one or more standard label records for each logical 
file, it is defined as such with its own file lable. 



Last 

Volume 

Label 



VTOC 
File Label 
(Format 4) 



VTOC 
File Label 
(Format 5) 
(Used by 
OS/VS 
only) 



File 
Labels 



Filename— 

xxxxxx 

Format 1 
Label 



Additional 
File Labels 



Filename = 
XXXXXX 
Additional 
Extents 
(Format 3) 



Pointer to 
last active 
file label 



Pointer to 
additional 
file extents, 
if necessary. 



Function of the VTOC 

Before a DASD file can be processed by logical IOCS, the file must be opened to 
permit transfer of data. The open routines check the DASD labels identifying the 
file. This is accomplished by comparing the information from the actual file 
labels in the VTOC with the label information in the SYSRES label information 
cylinder. (See LSERV in this Section for a description of the label cylinder.) 

The illustration opposite is a overview of how DOS/VS uses the VTOC. 



DASD Label Formats 

The VTOC contains all format labels. Each format label points to an area of DASD 
storage on the volume and indicates what the area is currently being used for. A 
format 1 label describes one to three physical areas (extents) on the volume. It is 
the first format label used to describe each file. 

A format 2 label describes a file as being indexed sequential. If a format 2 label is 
used, there is always a format 1 label describing the same file. 

A format 3 label describes from one to thirteen extents on the volume. It is used 
when a file is made up of four to sixteen extents (the format 3 label is always 
associated with a format 1 label). 

A format 4 label describes the VTOC. 

A format 5 label is not used by DOS/VS. 

The following illustrations show the layout of format labels 1 to 4, with examples 
of printouts from the VTOC display program. 

A detailed description of these label formats is given in DOS/VS Data Management 
Guide. 
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Prog 
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LVTOC 



Filename for DTF matches 
filename in DLBL statement 



job //DLBL Filename, File ID , etc. 

control // EXTENT Symbolic name, Volume number 



Standard Volume Label: 
Cylinder 0, Track 0, Record 3 
(Written during disk 
initialization) 



The VTOC 
Format 4 label 




Label information 
cylinder 




SYSRES 



During the OPEN routine: 

1. Read SYSRES label information. 

2. Locate the VTOC via the 
standard volume label. 

3. For DASD input files: 
Compare format 1 label information 
(or format 2 for IS files) to information 
in the DLBL card. 
Check each extent definition in 
format 1 and 3 labels against the 
limit fields in the EXTENT card(s). 
For DASD output files: 
Create the format 1 label from 
information in the DLBL/EXTENT 
cards. (Format 1 is always present 
followed by format 2 for IS files). 
If extra extents are to be described 
create format 3 labels following 
the format 1 or 2, or another format 3. 

During the CLOSE routine: 
1. Read, update, and rewrite format 1 
and 2 labels for IS files. 



An overview showing how the DOS/VS uses the VTOC. (Not applicable to VSAM 
files) Details are found in DOS LIOCS Vol 1 
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LVTOC Executing the VTOC display program 



The control cards necessary to execute VTOC in a virtual partition are: 

// JOBjobname 

// ASSGN SYS004,X'cuu' (input) 
// ASSGN SYS005,X'cuu' (output) 
// EXEC LVTOC 

/& 

The operator commands necessary are: 

1. Press REQUEST on the console printer keyboard 

2. PAUSE (BG F4, F3, F2, Fl), EOJ 

3. // ASSGN SYS004,X'cuu' (input device) 

4. // ASSGN SYS005,X'cuu' (output device) 

5. // EXEC LVTOC 

Where: 

• SYS004 is assigned to the channel and unit address (cuu) of the DASD on 
which the disk pack is mounted. 

• SYS005 is the output device, normally a printer. If the output device is not 

a printer, TLBL, DLBL, and EXTENT cards must be included to describe the 
output device. The filename for these cards is UOUT. 

The first of the two examples on the opposite page is a VTOC display using the 
LVTOC program. 

Two other methods of obtaining a VTOC display are as follows: 

• Instead of typing CANCEL to terminate the job, the operator can type 
CANCELV to get a VTOC dump on SYSLST, if SYSLST is a printer. Refer 
to the second example on the opposite page. 

• The operator can display the VTOC by typing DSPLYV (in response to an 
error message). This reply does not terminate the job, but reissues the same 
message issued prior to the VTOC display request. (The output can be 
directed to SYSLOG if SYSLST is not assigned.) Refer to the example at the 
end of this chapter. 

Operator actions given in DO S/VS Messages indicate methods to obtain a VTOC 
display for particular messages. 



When to use 

The five examples listed below illustrate when and how the VTOC display program 
can aid program debugging by providing details about your disk volumes: 

1. During disk pack initialization, the VTOC label is checked. A message is printed 
on SYSLOG if there is an unexpired file in the pack. If the contents of the pack 
are unknown or its validity is in doubt, a VTOC listing will enable you to check 
the unexpired file. You can then decide if the unexpired file is to be retained 
or replaced by different extents. 

2. Before copying a volume it is useful to keep a record of the contents of the 
volume to be copied and the volume that receives the copy. Having a record will 
reduce debugging time if an error occurs in a program that uses one or both of 
these packs. 

3. A VTOC display enables you to monitor and keep track of volume areas, thus 
allowing economical use of your packs. 

4. If the input data contained on a pack is causing program errors, a VTOC listing 
of the input volumes enables you to check for the presence (or absence) of data 
sets. 

5. If, during program execution, a system malfunction prevents workfiles from 
being properly closed by the CLOSE macro, it is probably that volumes used 
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during the program will cause program errors when used for future jobs. This is 
because the VTOC label would not have been updated by the CLOSE macro. It is 
useful, therefore, to obtain a VTOC listing of the volumes affected. 



LVTOC 



Examples of the LVTOC output 







VTOC DISPLAY UTILITY 






* LABEL IDENT - 


VOL1 


VTOC LOCATION IS CYLINDER - 199 


SERIAL NUMBER - 111111 OWNER 


IDENT - 


* T O.R 1 FCRMAT 4 


LAST ACTIVE UNUSED ALTERNATE TRACK INFORMATION 
FORMAT 1 LABELS LOCATION NO. OF TRACKS 


EXTENT INFORMATION 
SEQ TYPE LOW HIGH 






473 200 




60 


PRIME 199 199 18 


T O.R 2 FORMAT 5 


USEO 


ONLY BY 0/S 360, NOT SUPPORTED BY DOS 










* T O.R 3 FORMAT 1 




SERIAL NUMBER - 111111 LENGTHS 
FILE ID KEY BLOCK 


RCO 


DATES 
CREATE EXPIRE 


SYSTEM 

IDENT 


EXTENT INFORMATION 
SEQ TYPE LOW HIGH 


* PAGE DATA SET 




2048 


2048 


73 278 99 365 


IBMDOSVS 


180 186 19 


* T OtR 4 FORMAT 1 




SERIAL NUMBER - 111111 LENGTHS 
FILE ID KEY BLOCK 


RCD 


DATES 
CREATE EXPIRE 


SYSTEM 
IDENT 


EXTENT INFORMATION 
SEQ TYPE LOW HIGH 


9 DOS. RECORDER. FILE 










73 278 99 365 


IBMDOSVS 


1 PRIME 198 0' 198 19 


* T 0,R 5 FORMAT 1 




SERIAL NUMBER - 111111 
FILE ID 


LENGTHS 
KEY BLOCK 

&) ° 


RCD 



DATES 
CREATE EXPIRE 

73 278 73 249 

DATES 
CREATE EXPIRE 

73 278 99 365 

'SAM ,£& 


SYSTEM 
IDENT 

IBMOOSVS 

SYSTEM 

IDENT 

IBMDOSVS 


EXTENT INFORMATION 
SEQ TYPE LOW HIGH 

1 PRIME^ 21 14 41 13* 

EXTENT INFORMATION 
SEQ TYPE LOW HIGH 

1 PRIME 1 20 19 

(£x 37KT) 


W | BUG. GENERATOR, WORKFILE.K 

T O.R 8 FORMAT 1 

O 

DOS.WORKFILE.NO.O 
* END OF VTOC LISTING 


TOMS iS/ 2 * ^"^f 


SERIAL NUMBER - 111111 
FILE ID 


LENGTHS 
KEY BLOCK 




RCD 



u 


k/dcsut/Zt. 


6 i 




An example of the output on a line printer after executing the LVTOC program 




An example of the output on a line printer after issuing the CANCELV command 
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LVTOC 



BG 

|BG ASSGN SYSPCH»X'131' 

;BG 4444A OVERLAP ON UNEXPRD PILE 

i BUG - GENERATOR r UORKF ILE . K . TOMS 

! BG c.l i> p I y v ■* — ■ — 

;BG 4V95A SYSLOG OR SYSLST 

i BG r. y <> I o <•) ^_ ^^^ 

' BG " ■ 



I JS YSPH S YSPCH= 1 3 1 1 1 1 1 1 1 



- oufeu/- fc sys^og 



BG VOLUME SERIAL NO.. IS 111111 



.BG PAGE DATA SET 

!BG 2100 00B40000-00BA0013 



;BG DOS .RECORDER -FILE 

.'BG 0101 OOC60000-OOC60013 

\ BG (iBUG ■ G ENERATOR > UORKF 1 LE~ . K . TOMS I 
! BG vO 1 1 tf >0 1 5000E 1 -'0029000I 



10/04/13 
1 1 1 1 1 1 1 1 D 1 1 5 ■ 63016 D 

1111111 0001 ODO 11 5-630 16D 
1 1 1 1 1 1 1 (000?) D 1 1 5 - 4 9 F 9 




cy hi> cy ho 

DRKFILE.NO.O 
:)00 10000 -00 1400 13 



;BG DOS.WORKFILE.NO.O 

.BG 0101 00010000-00140013 



^ mil 1 1 



0001 ODO 11 5-630 160 



.BG MTOC DISPLAY COMPLETED 



A 



£x39KT 



An example of the output on a 3215 console printer keyboard after issuing the 
DSPLYV command. 




An example of the output on a line printer after issuing the DSPLYV command. 
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The SYSVIS DUMP program copies the contents of the page data set (PDS) SYSVIS DUMP 

contained on the system logical unit SYSVIS on to magnetic tape or disk pack. 
A printout on SYSLST can then be obtained for use during offline program 
debugging. The utility also enables you to dump the contents of the PDS directly 
to SYSLST, which can be assigned to a tape unit, a disk drive, or a line printer. 

The SYSVIS dump may also be referred to as the Page Data set dump. 

Restrictions 

This utility program can be used only to copy or dump the contents of the PDS 
contained on SYSVIS. Any other use is automatically rejected by the system. 
Because paging must not occur during execution of this utility when dumping 
from SYSVIS do not start or run any other jobs either before or during its execution. 

Description and operation 

This utility program is initiated by normal JCL through SYSLOG or SYSIPT by 
the execute statement // EXEC PDSDM. Parameters entered either through 
SYSLOG or SYSIPT enable you to select areas of SYSVIS, thus avoiding the 
need to dump all of the virtual address area contained on SYSVIS. 

The following areas can be selected: 

• The entire PDS, that is, all the virtual address area 

• Any specified virtual partition 

• One or more pages contained within any virtual partition. 

Multiple parameters can be specified but they must be confined to one card 
image. Multiple cards are possible. 

For example: 

BG, (089ABC,08ABCD), F4 punched in a card or entered through SYSLOG 
causes a dump of the whole of the background and foreground 4 virtual 
partitions, and the pages on the PDS that contain any addresses between the 
address limits 089ABC and 08ABCD. 

(Addresses are specified by six hexadecimal digits.) 

The dump output is directed to SYSLST or SYS001, depending on the parameters 
specified. For example, a response to SYSLST to the message 0V23D TO= causes 
the dump to be directed to the device assigned as SYSLST. 

If SYS001 is used as the input or output device, tape or disk label information 
must be supplied in the job stream. 

If the dump is from SYSVIS, it is accessed by assigning SYS000 to it. The 
necessary disk label information must then also be supplied in the job stream. 

Job stream examples are shown on the following pages. 

The format of the dump output is similar to the output obtained from the 
stand-alone dump, that is, each 2K of virtual storage contained on the PDS is 
separated and given a block number starting with BLOCK 0000. Blocks 
containing only zeros are suppressed. An example of the stand-alone dump 
output is shown in Appendix G. 
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SYSVIS DUMP How to execute 



Because this utility consists effectively of three separate utility programs, it is 
necessary to show three sample job streams. 

Example 1 shows the job stream required to copy SYSVIS to SYS001, where 
SYS001 can be assigned to either a tape unit or a disk drive. 

Example 2 shows the job stream required to dump SYS001 to the device assigned 
to SYSLST. 

Example 3 shows the job stream required dump SYSVIS directly to the device 
assigned to SYSLST. 

To ensure that the contents of the PDS and the allocations of the virtual address 
area are the same as they were just prior to the execution of the stand-alone dump 
the following instructions must be adhered to: 

1 . Re-IPL using identical parameters for the DPD command as specified in the 
previous system IPL. However you must specify N to the parameter TYPE=. 

2. Check for any previous ALLOC commands. You must specify identical virtual 
partition allocations as existed just before the stand-alone dump was executed. 

Example 1: Copying SYSVIS to SYS001 on tape or disk. 
(SYS001 must be a DASD device) 

// JOB COPYPDS where CUU is the physical address 

// ASSGN SYSOOO,X'cuu' of SYSVIS. 

// ASSGN SYS001 ,X'cuu' where CUU is the physical address 

of the device to be used as 
temporary storage for the PDS. 

// DLBL PDSDISK/PAGE DATA SET 

// EXTENT SYS000 

// DLBL S01 DISK/BACKUP FOR PDS' [,date] 

// EXTENT SYS001,vol ID, Relative starting address, number of tracks 

If the PDS copy is to be on tape, replace the previous two statements by the 
following: 

// TLBL S01TAPE/BACKUP FOR PDS' 

followed by: 

// EXEC PDSDM where PDSDM is the phase name 

for the utility contained on the 
system core image library. 
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Example 2: Dumping SYS001 to SYSLST 

// JOB DUMPPDS 
//ASSGNSYS001,X'cuu' 

// DLBL PDSDISK/BACKUP FOR PDS' 
// EXTENT SYS001 



Library Display Programs and Utilities 

SYSVISDUMP 



where CUU is the physical 
address of the device containing 
the copied PDS. 



If the copied PDS is on tape, replace the previous two statements by the following: 

// TLBL PDSTAPE/BACKUP FOR PDS' 
followed by: 

// EXEC PDSDM 

If parameters are to be read through SYSIPT respond to message 0V20D with 
IPT, press the END key and use the following statement: 

TO=SYSLST, T followed by the cards containing the parameters and 

/& 

Respond to message 0V20D with LOG and press END if parameters are to be 
read through SYSLOG. 

Only pressing the END key as the answer to message 0V20D causes a dump of the 
whole PDS to SYSLST. 

If LOG is entered followed by END key the following message is issued on 
SYSLOG: 

0V23D TO= 

Respond to this with: 

SYSLST T This selects SYS001 as input device and SYSLST as output 
device for the dump. 

This is followed by the message: 

0V21D GIVE PARAMETERS 

Pressing the END key after entering parameters causes an immediate dump of the 
areas specified followed by the message: 

0V21D GIVE PARAMETERS 

Further parameters can be entered but if no more areas of the PDS are to be 
dumped, either enter EOJ or press the END key. This terminates the job. 

Note: On Models 115 and 125 the END key is replaced by the ENTER key. 
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SYSVIS DUMP Example 3: Dumping SYSVIS direct to SYSLST. 

// JOB DUMPPDS 

// ASSGN SYS000,X'cuu' where CUU is the physical address of 

SYSVIS. 
// DLBL PDSDISK/PAGE DATA SET' 
// EXTENT SYSOOO 
// EXEC PDSDM 

If parameters are to be read through SYSIPT this must be followed by: 

TO=SYSLST followed by the cards containing the parameters and 
/& 

Respond to message 0V20D with either LOG or IPT and press the END key. 
(END key only is an invalid response.) If LOG is entered followed by END key 
the following message is printed on SYSLOG: 

0V23D TO= 

Respond to this with SYSLST. This selects SYSVIS as input device and SYSLST 

as output device for the dump. 

This is followed by the message; 

0V21D GIVE PARAMETERS 

Pressing the END key after entering parameters causes an immediate dump of the 
specified areas of SYSVIS and is followed by the message: 

0V21D GIVE PARAMETERS 

Further parameters can be entered, but if no more areas of SYSVIS are to be 
dumped either enter EOJ or press the END key to terminate the job. 

Pressing the END key before entering parameters causes the whole PDS to be 
dumped on SYSLST. 

Note: On Models 115 and 125 the END key is replaced by the ENTER key. 
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Error messages SYS VIS DUMP 

The list below summarizes the error messages that are printed on SYSLOG to 
inform the operator of incorrect job stream input: 

• Invalid parameters are specified. 

• SYSLST or SYS001 is incorrectly specified. 

• Start address is greater than end address. 

• Partition is not allocated. 

• Address or partition is in real storage. 

• Address is greater than end of virtual storage. 

• Partition ID is invalid or greater than number of partitions allocated. 

• Incorrect assignments for SYS000 and/or SYS001 . 

• Attempt to dump a file other than the PDS. 

Incorrect addresses and partition IDs are flagged by an asterisk* printed on the 
line below. For example: 

BG bg,0809ab,f4,148000,05f5ee,(0809ab,096000)f2, 

BG * 

BG 0V40I ADDRESS IS OUTSIDE OF VIRTUAL PARTITIONS 

Pressing the END key causes the areas that are specified correctly to be dumped 
up to the first invalid parameter. The incorrect parameters can be corrected 
through SYSLOG. If the input is through SYSLOG, further parameters can be 
specified after the message: 

0V21D GIVE PARAMETERS 

If the input is through SYSIPT, you can switch back to SYSIPT as input device 
for specification of further parameters by entering IPT to the message: 

0V21D GIVE PARAMETERS 

Terminating the dump 

This can be done in any of the three ways given below: 

• Enter EOJ on SYSLOG 

• Having a /* or a /& card at the end of the job stream when entering 
parameters through SYSIPT. 

• Pressing the END key in response to the message: 0V2 ID GIVE 
PARAMETERS after at least one address has been processed. 

Note: On Models 115 and 125 the END key is replaced by the ENTER key. 
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SYSVISDUMP 



When to execute the dump 



It is recommended to obtain a dump of SYSVIS whenever a stand-alone dump is 
executed. SYSVIS DUMP should not be executed until the stand-alone dump has 
been completed, and should be initiated during the system re-IPL. To help your 
analysis of the information contained in the SYSVIS dump it is also recommended 
to execute a formatted stand-alone dump as described in A-3 of this Section. For 
this reason, execution of this utility is included in the flowchart A-3-F "Executing 
the Stand Alone Dump". 



How to use the dump output 

During analysis of a system malfunction, such as a HARD WAIT STATE using a 
stand-alone dump output, it may be necessary to analyze the coding in a page 
belonging to a virtual partition which was not in real storage when the stand-alone 
dump was executed. 

The virtual address allocations can be obtained from the BOUNDARY BOX, and 
pages not in real storage can be found by analyzing the contents of the PAGE 
TABLE. The format and contents of the boundary box and the page table are 
described in Section 4, Chapter 12 of this manual. 

Therefore, the SYSVIS dump should be used in conjunction with the stand-alone 
dump output. It is recommended to always use a stand-alone dump generated with 
the DUMPGEN parameter FORMAT=YES. DUMPGEN is described in A-3 of 
this Section. 

It is essential that the operator save the copy of the PDS after executing the 
stand-alone dump. You as the system programmer, or the IBM CE/SE will then be 
able to print out all or any part of the PDS to complete problem analysis. 
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ALTER/DISPLAY 
FEATURE (ALL MODELS) 



The ALTER/DISPLAY facility allows the operator to dump or display, and 

change the contents of various parts of the CPU storage (depending on the CPU 

Model) and of real or virtual storage. 

For the purpose of hands-on debugging, the following areas may need to 

be displayed: 

Any selected area of virtual storage 
General registers 
Floating-point registers 
Current PSW 
Control registers 



When to use 

ALTER/DISPLAY is useful for hands-on debugging, and enables the operator to 
obtain information about the system at the time a malfunction occurs. It must 
be used whenever a display of the low address storage is required, for example, 
to record a wait state message (see E-3 in this section). 

Flowcharts in section 3 indicate when to use this facility, and which option to 
choose for a particular system malfunction 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for example, a program using MICR or teleprocessing as input/ 
output, must be considered before using this serviceability aid. 
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How to use this feature 



Aids provided by the Operator's Console 



ALTER/DISPLAY 

MODELS 135 

AND 145 







CANCEL 


INTVN 
REQD 










NOT 
READY 




READY 












r 
ALTER/ 
DISPLAY 


ALT/DISP 
MODE 





nsssQmcDcgoGDQSSo 

J00000000Q00 

00000000000 



RETURN 



b 000000000m F^n l^lJ 

I Spacebar I 




► 
► 



Indicator 


Condition 


INTVN 
REQD 


The console printer is out of forms or the 
PR-KB is not ready. 


ALT/DISP 
MODE 


A request for an alter/display operation was 
accepted. 


ALARM 


An alarm command was issued, and manual 
intervention is required by the operator. 


PROCEED 


The PR-KB is unlocked and ready to accept 
characters. This indicator is turned on by the 
ALTER/DISPLAY key or by a read command. 


REQUEST 
PENDING 


A request operation was initiated. The indicator 
is turned off when the attention status is 
accepted by the CPU. 



Indicator 



► 

► 



Key 


Function 


NOT READY 


Places the console printer in a not-ready condition. 


CANCEL 


Used to terminate a read command when the operator has 
made an error in data entry. Normally, the program will 
issue the same read command again. 


READY 


Places the PR-KB in the ready state when forms are in the 
printer and the cover is closed. 


ALTER/ 
DISPLAY 


Requests or ends an alter/display operation. When used to 
end an alter /display operation, the PR-KB remains in alter 
/display mode. 


END 


Terminates a read, write, or alter /display operation. 


ALARM 
RESET 


Resets the ALARM indicator. 


REQUEST 


Initiates the attention routine to enable operator/ 
system communication 



Key 



Indicators and Control Keys (3210 and 3215 printer keyboard) 
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ALTER/DISPLAY 
MODELS 135 145 
AND 115-11 



Table D- 1 below summarizes the ALTER/DISPLAY options that can be selected 
when using the flowchart shown in D- 1 -F. 



Mnemonic 


Storage 
Area 


Address Range 


Alter 


Display 


AM 


DM 


Real address area 


000000-03BFFF* 


AV 


DV 


Virtual address area 


000000-1 6 megabytes 


t 
AG 


DS 
DG 


Control storage 
General register 


0000-DFFE*+ 
0-F 


AF 
AP 


DF 
DP 


Floating-point register 
PSW 


0,2,4,6 

None 


AC 


DC 


Control register 


0-F 


AK 


DK 


Storage key 


000000-03BFFF* 


AX 


DX 


Transmission speedtt 


1—8 (line number) 



Use address length shown; if necessary, fill-up with leading zeros. 

* Model-dependent. 

t You cannot alter control storage data. 

+ Control storage addresses are not continuous. For control storage address to be 
valid, leftmost (fourth-highest) digit must be: 

1 . For 24K control storage size; 0—5 

2. For 36K control storage size, 0—5, 8, A, or D(hex) 

3. For 48K control storage size, 0—5 or 8— D(hex). 

tt Line speed can only be changed if, with your ICA feature, you have the SDA 
II subfeature with clocking provided by the Model 135. = 600 bits per second, 
1 = 1200 bits per second. 



Table D-l. Options for the ALTER/DISPLAY feature. 



Notes: When the operation is ended with the ALTER/DISPLA Y key, the keyboard 
remains in ALTER/DISPLA Y mode ( ALT /DISP MODE indicator on). When the 
operation is terminated with the END key, ALTER/DISPLA Y mode is terminated. 

For ALTER/DISPLA Y of general and floating-point registers, a wraparound is 
performed (F to for general registers, and 6 to for floating-point registers). 
When addressing virtual storage, either a word or byte address may be used. If the 
starting address is not on a word boundary, the console printer spaces and aligns at 
the byte addressed. 
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m& 



Yes 



Start 



Press STOP and wait until 
MAN indicator turns on 



Press ALTER/DISPLAY 
(printer-keyboard) and wait 
until PROCEED Light 
(printer-keyboard) turns on 



Type two-character 
mnemonic and hex address 



Specifies: 

1. Alter or display 

2. Storage area 

3. Address in virtual 
storage 

See table D-1 

for choice of options. 




No 



Type hex data to alter 
information as required. 
(See "Format of Printout. 



Display — printer-keyboard 
print required data. (See 
"Format of Printout." 




Press END 
(printer-keyboard) 



To resume processing 
press START 



Aids provided by the Operator's Console 

ALTER/DISPLAY 

MODELS 135, 145, 

AND 155-11 



Carriage return and line feed occurs. 
ALT/DISP MODE indicator turns on. 




Data may be entered, one digit at a 
time, using the space bar to skip over 
positions not being altered. The data 
in the skipped-over positions remains 
unchanged and is printed out each 
time the space bar is operated. To 
end the operation, press the END or 
the ALTER/DISPLAY key. 



Data is printed starting at the address 
specified and continued until the 
END or the ALTER/DISPLAY key is 
pressed. (Contents of locations or 
registers are not affected.) 



Line feed occurs; ALT/DISP MODE 
indicator turns off; system is in the 
manual state. 
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'%JP 



Aids provided by the Operator's Console 



ALTER/DISPLAY 
MODELS 135, 145, 
AND 155-11 



Format of printout 

Starting at the specified address, the display is printed in groups of eight characters 
with up to eight groups per line. Depending on your starting address, the initial 
group might not contain eight characters. When general and floating-point registers 
are displayed, the address sequence 'wraps,' that is, the highest available address 
is followed by the lowest address (zero). 

When altering, enter new hex characters in the positions occupied by the characters 
to be replaced. Reach the required positions by repeating characters, to be > 
retained. 

Examples are shown below of the printout (reduced in size) from a 3215 console 
printer by using the ALTER/DISPLAY feature. 

Example 1 

This example shows a display of the 

• current PSW (DP) 

• general purpose registers (DG) 

• control registers and 

• low address storage. 




Example 2 

In this example, the contents of control registers 9,10, and 1 1 were altered. First 
the operator displayed the contents by using the DC option. Then using the AC 
option, he entered the new data. To ensure that the data change was successful, 
the operator has displayed the control registers again. 





























• 

• 

■«■•■ 


no 9 

OH23LKK) 
■ O000E640 

"": ac 9 

': OOOOOQAA 

i no 9 

-t OGOOOOM 
! 0000E640 

'"T 

, 1, ||ni „., 














004000FF 
OOOOEOOO 






OOOOOOO0 

FFFFFFFF 


00000000 

FFFFFFFF 


00000000 
00000000 


00000000 
00000000 


C2000000 
00000000 


00000200 
00000000 






AA©?£300 


DEF 12301 














FFFFFFFF 


DEF 12361 
FFFFFFFF 


00000000 
00000000 


00000000 
00000000 








C2000000 
00000000 


00000200 
00000000 


004000FF 
OOOOEOOO 


















(fxte/ftf 
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Aids provided by the Operator's Console 

Error Messages ALTER/DISPLAY 

MODELS 135, 145, 
An ALTER/DISPLAY operation is terminated when an ALTER/DISPLAY error AND 1 55-1 1 

message occurs or when the end of a storage area or register is reached. 

Model 135 Alter /Display Error 

Invalid character: An invalid character is created when you use the mnemonic not 
shown in the table, when you address a feature not installed on your system, or 
when you enter an address or data character that is not a hex digit. An invalid 
character is ignored (no print or space occurs). Continue by entering the correct 
character— it is not necessary to restart the whole operation. 

Invalid address: An invalid address is created when your address is not addressable 
location (the address might be outside the storage capacity of your system or you 
may be trying to address a virtual address that is not in the real address area) or 
when you address an ICA line either not installed or not fitted with the SDA II 
sub feature with clocking by the Model 135. An invalid address terminates the 
operation with the message '?ADR.' You must start again. 

Invalid Data: When changing the transmission speed for a communications link 
(AX or DX mnemonics), the only valid data characters are '0' or '1 .' When any 
other hex character is entered, the operation is terminated with the message 
'?DATA." The transmission speed remains unaltered. 

Invalid -Format PSW: When you enter an invalid -format PSW, the PSW is 
altered but an interruption is generated when the invalid PSW is subsequently 
used. 

Model 145 Alter/Display Error 

Invalid Character: INVAL CHAR is printed if one of the following occurs: 

• The first character of a mnemonic is not A, D, or T (see Keyboard Test 
Mode Operation). 

• The second character is not M, S, L, K, C, G, F, or P. S and L are reserved 
for service personnel. 

• An invalid digit is typed when addressing or altering data. 

• The CANCEL key is pressed. 

Invalid Address: INVAL ADDR is printed if one of the following errors occurs: 

• Invalid starting address. 

• The updated address exceeds the capacity of specified storage. 

• The operator performs an AS or AL operation. 

• You may be trying to address a virtual address that is not in the real 
address area. 



Model 115-11 

As a result of the editing function, the following indications are given: 

1. If an invalid character is detected in the op code, storage mnemonic, or hex digit 
(0-9 and A-F), the printer does not respond. The operator can then rekey the 
correct character. 

2. If an invalid address (beyond the physical storage) is detected the error message '?' 
is printed. 

3. If an alter PSW operation is invalid, the PSW is restored to its original value 
and '?' is printed. 
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Aids provided by the Operator's Console 

ALTER/DISPLAY The ALTER/DISPLAY facility allows the operator to display or change the 

MODE LS 1 1 5 AND 1 25 contents of the following parts of the CPU (Central Processing Unit), and of real 

or virtual storage areas: 

• General registers 

• Floating-point registers 

• Current PSW 

• Control registers 

• Protection keys 

• Real storage areas 

• Virtual storage areas. 

A "hard copy" of all information displayed on SYSLOG can be obtained on a 
Model 115 and 125 with a 5213 printer attached by pressing the COPY key after the 
information is displayed. 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for example a program using MICR or teleprocessing as input/ 
output, must be considered before using this serviceability aid. 
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Aids provided by the Operator's Console 



How to use 



ALTER/DISPLAY 
MODELS 115 AND 125 



Before the ALTER/DISPLAY feature can be used, the mode select display shown 
below must be brought to the screen by pressing the MODE SELECT key. 



MODE SELECTION 



R SYSTEM RESET 

C ADDRESS COMPARE 

L PROGRAM LOAD 

T INTERVAL TIMER 

K CHECK-CONTROL 

D STORAGE DUMP 

E ICA LINE MODES 
MODE SPECIFICATION: 



A ALTER/DISPLAY 

I INSTRUCTION STEP 

P RESTART 

M MAINTENANCE 

S STORE STATUS 

U SAVE USAGE COUNTERS 




To select the ALTER/DISPLAY feature: 

1. Type A into the mode select display. 

2. Press the ENTER key. 

The ALTER/DISPLAY picture as shown below is brought to the screen and 
shows those parts of the CPU and real/virtual address areas that can be altered 
and/or displayed. 



* ALTER/DISPLAY * 

G GENERAL REGISTERS 

C CONTROL REGISTERS 

P CURRENT PSW 

F FLOATING POINT REGISTERS STORAGE ADDRESS 

K PROTECTION KEY 000000 - FFFFFF 

M MAIN STORAGE REAL 000000 - FFFFFF 

V MAIN STORAGE VIRTUAL 000000 - FFFFFF 



MODE SPECIFICATION: 



To select a particular display: 

1. Type in the associated mnemonic according to the instruction given in the 
next flowchart. 

2. Press the ENTER key. 

Before ENTER is pressed, you can still change your input by using the cursor 
keys and entering the changes in the usual way. As soon as ENTER is pressed, 
the new data replaces the old. The display remains on the screen and the 
cursor is at the next ALTER/DISPLAY line. Because there is an A (for 
ALTER/DISPLAY on this line, you need only enter F (for floating point 
registers) or P (for PSW), and so on. 
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Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 115 AND 125 



G 

GENERAL 

REGISTERS 


To display: 

1 . Type G into the alter/display picture. 

2. Press ENTER. 

All general registers appear at once. 


F 

FLOATING- 
POINT 
REGISTERS 


To display: 

1 . Type F into the alter/display picture. 

2. Press ENTER. 

All floating-point registers appear at once. 


P 

CURRENT PSW 


To display: 

1 . Type P into the alter/display picture. 

2. Press ENTER. 

The current PSW is displayed in binary notation, except for the 
instruction address, which is in hex. BC or EC mode is indicated in the 
machine status area, line 14, and in the E-bit in the PSW. 

o BC Mode: The system is in basic control mode when the E-bit 

is zero, 
o EC Mode: The system is in extended control mode when the E-bit 
is 1 . 


C 

CONTROL 

REGISTERS 


To display: 

1 . Type C into the alter/display picture. 

2. Press ENTER. 

All control registers appear at once. 


K 

PROTECTION 

KEY 


To display: 

1 . Type K into the alter/display picture. 

2. Type in the main storage address in hex. 

3. Press ENTER. 

In the protection key display: 
o The address is in hex. 
o The key is in binary. 

o The reference (R), the change (C), and the protection (P) bits 
are in binary. 


M 

MAIN 
STORAGE 
REAL 


To display: 

1 .Type M into the alter/display picture. 

2. Type in the main storage address in hex. 

3. Press ENTER. 

The display shows 32 halfwords of main storage at once. The Y characters 
in the format illustration represent, in hex, the main storage address with- 
out its low-order digit. The missing low order digit of the address is shown 
above each leftmost byte of each halfword. 


V 

MAIN 
STORAGE 
VIRTUAL 


To display: 

1 . Type V into the alter/display picture. 

2. Type in the address. 

3. Press ENTER. 

The display shows 32 halfwords of virtual storage at once. The R char- 



Examples following the flowchart opposite show the format of the various 
displays and describe error indications where applicable. 

Table D-2 Options for the ALTER/DISPLAY console feature 
(Models 115 and 125) 
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Press MODE SELECT 



Type in A and press 
ENTER 



Specify the display 
required by typing in the 
associated mnemonic 



Press ENTER 



Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 115 AND 125 



If you have a display, selected from the 
Alter/Display set or other service function, 
and then press MODE SELECT, the 
Alter/Display picture will appear. To get 
the mode select picture you have to press 
MODE SELECT twice 



Refer to the list of mnemonics and 
instructions given on the opposite 
page. 



D-2-F 



NO 



Make a note of the required 
instruction address and 
contents displayed. 



Figure D-2 parts 1 and 2, 
illustrate the displays asso- 
ciated with the mnemonics, 
and describe error indica- 
tions where applicable. 




To alter any of the dis- 
played contents, move the 
cursor under the first digit 
and type in the new data. 



Press ENTER 



YES 



YES 



Press MODE SELECT twice 




Press CANCEL 



Select the 
new mode 



To resume processing 
Press START 



The first digit can be hexadecimal 
or binary, depending the display 
specified. The new contents appears 
on the line below the original until 
the ENTER key is pressed. 



The original display is replaced to 
display the new contents. 



The last picture of the operating 
system is brought back to the screen 
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Aids provided by the Operator's Console 



ALTER/DISPLAY 
MODELS 115 AND 125 



Error messages 

If logical errors are made while altering 
the current PSW, one or any of the 
following error indications may be 
displayed: 

1. EC-PSW ERROR 

2. INVALID ADDRESS LOADED 

3. ADDRESS NOT TRANSLATE- 
ABLE 

Message 1 indicates PSW rejection, 
which is caused if bit 1 2 of the PSW 
is set to zero. Messages 2 and 3 
indicate that the PSW has been loaded, 
but a program check will occur when 
an attempt is made to continue 
operation. 

Message 3 occurs in case of invalid 
page or segment table address 
specification exception. 



Format of displays and error indications 

The following illustrations show the amount and format of information displayed 
with the associated mnemonic. When a wrong character (either a non-hex or a non- 
binary as the case may be) is entered, INVALID CHARACTER appears. The 
cursor marks the first invalid character. 



GENERAL REGISTERS 



ALTER/DISPLAY GENERAL REGISTERS (HEXADECIMAL) 



0000 0000 1 0000 0000 2 0000 0000 3 0000 0000 



4 0000 0000 5 0000 0000 6 0000 0000 7 0000 0000 



8 0000 0000 9 0000 0000 A 0000 0000 B 0000 0000 



C 0000 0000 D 0000 0000 E 0000 0000 F 0000 0000 



NEXT ALTER/DISPLAY: A 



FLOATING POINT REGISTERS 



ALTER/DISPLAY FLOATING POINT REGISTERS (HEX) 



0000 0000 0000 0000 



2 0000 0000 0000 0000 



4 0000 0000 0000 0000 



6 0000 0000 0000 0000 



NEXT ALTER/DISPLAY: A 



Current PSW 



ALTER/DISPLAY CURRENT PSW 



SYST.MASK KEY 

0000 0000 0000 



EMWP ILC CC 



PROGRMASK 



INSTRUCTION ADDRESS: 000000 
ADDRESS IN HEX, OTHER DATA IN BINARY 



NEXT ALTER/DISPLAY: A 



Figure D-2, part 1 of 2. Format of the displays for Models 115 and 125. 
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CONTROL REGISTERS 



ALTER/DISPLAY CONTROL REGISTERS (HEXADECIMAL) 



0000 00E0 1 0000 0000 3 FFFF FFFF 3 FFFF FFFF 
4 0000 0000 5 0000 0000 6 0000 0000 7 0000 0000 



8 0000 0000 9 0000 0000 A 0000 0000 B 0000 0000 

C 0000 0000 D 0000 0000 E C200 0000 F 0000 0200 



NEXT ALTER/DISPLAY: A 



K PROTECTION KEY 



Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 115 AND 125 




ALTER/DISPLAY PROTECTION KEY 



ADDRESS: 00002F KEY: 0000 



NEXT ALTER/DISPLAY: A 



Error messages 

INVALID ADDRESS appears if the address 
is larger than the real storage size. 

The address has to be typed in with leading 
zeros. When selecting the alter /display 
protection key display, do not use any 
commas or blanks. 



MAIN STORAGE REAL 



* ALTER/DISPLAY MAIN STORAGE REAL (HEXADECIMAL) * 

02 46 8 A C T 

00012 0000 0000 0000 0000 0000 0000 0000 0000 

00013 0000 0000 0000 0000 0000 0000 0000 0000 

00014 0000 0000 0000 0000 0000 0000 0000 0000 

00015 0000 0000 0000 0000 0000 0000 0000 0000 
NEXT ALTER/DISPLAY: A 



V ALTER/DISPLAY MAIN STORAGE VIRTUAL 



ALTER/DISPLAY MAIN STORAGE VIRTUAL (HEX) 



REAL: 03E28 2 4 6 



61A94 D0E3 AB13 5478 4ABE 0000 0000 0000 0000 



61A95 0000 0000 0000 0000 0000 0000 0000 0000 



61A96 0000 0000 0000 0000 0000 0000 0000 0000 



61A97 0000 0000 0000 0000 0000 0000 0000 0000 



NEXT ALTER/DISPLAY: A 



Error messages 

If the contents of the virtual address 
entered is not in real storage the 
virtual storage area will not be 
displayed. Instead one of the following 
messages will be displayed: 
OUTSIDE PAGE TABLE 
OUTSIDE SEGMENT TABLE 
PAGE ENTRY INVALID 
SEGMENT ENTRY INVALID 
SPECIFICATION EXCEPTION 
ADDRESSING EXCEPTION 



Figure D-2, part 2 of 2. Format of the displays for Models 115 and 125 
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Aids provided by the Operator's Console 



ALTER/DISPLAY 
MODEL 158 



The ALTER/DISPLAY facility allows the operator to display or change the 
contents of the following parts of the CPU (Central Processing Unit), and of real 
or virtual storage areas: 



General registers 
Floating-point registers 
Current PSW 
Control registers 
Protection keys 
Real storage areas 
Virtual storage areas 



Real Channel UCWs 
Logical Channel UCWs 
Active UCWs 
CPU Local Storage 
I/O UCW Local Storage 
I/O Buffer Local Storage 



How to use 

The ALTER/DISPLAY frame, shown below, can be entered only from the 
MANUAL or SERVICE frame when the CPU is in the stopped (manual) state. 




A procedure for using this facility is shown in the flowchart on the opposite page. 

Error Indications 

All address characters are checked as they are entered for hex values 0-F. 
Invalid characters are not displayed and the console alarm sounds. 

If the cursor stays in the reset position (under the Y in Key In/ Address) and if the 
console alarm sounds, an invalid function code has been entered. A valid function 
code must be entered before the cursor will reposition to the right (one position). 

Printing displayed information 

A "hard copy" of all information displayed can be obtained on a Model 158 with 
a 3213 printer attached by pressing the COPY key after the information is displayed. 

Note however, that the following frames cannot be printed: 

• PROGRAM 

• ALTER/DISPLAY 

• INDEX 

(and when using the ALTER facility, only lines that have been changed by entering 
new data will be printed on the 3213 printer.) 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for dxample a program using MICR or teleprocessing as input 
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Aids provided by the Operator's console 



G> 



If the function requires 
an address the cursor 
moves to the first digit 
under KEY IN/ADDRESSf 
(see the note below) 

The cursor moves to 

the right until the 

address is complete fpS® ssSS< 

The cursor will pos- 
ition itself under the 
first digit of the con- §§§§ 
tents of the location §§1§ 
at the specified address 

The cursor will pos- 
ition itself at the next 
digit that can be altered 



Press STOP, 

then 

Press MODESEL 



ALTER/DISPLAY 
MODEL 158, 



Type in F3, or press 
light pen to lozenge. 
3-ALTER /DISPLAY 



|The MANUAL frame will be 
fdisplayed 

fThe ALTER/DISPLAY frame 
i wi 1 1 be displayed as shown on 
;|the opposite page 



ALTER 




DISPLAY 



Type in A or press 
light pen to lozenge 
■ A-ALTER 



Type in the associated 
r! mnemonic for the 

function to be altered, or 
use the light pen. 



Type in an address or 
use the light pen 



Press ENTER or COPY, 
or use light pen 



Type in new data or 
use the light pen. 



Press ENTER, or COPY, 
or use light pen. 



Yes 




Type in D or press 
light pen to lozenge 
■ D-DISPLAY 



Type in the associated 
mnemonic for the 
function to be dis- 
played, or use the 
light pen. 



If locations are to be 
displayed type in, or use 
light pen to enter the 
address in six hex digits 



i If the function requires 
fan address the cursor moves 
|to the first digit under KEY 
|IN/ADDRESS (see note 
I below) 



|The cursor moves to the 
fright until the address is 
I complete 




Press ENTER, or COPY 
or press light pen to 
lozenge ■ COPY. 



Yes 



Press CANCEL 




No 





Yes 



Note 1: 

An address is not required to 

alter or display the following: 

• Control registers 

• General purpose registers 

• Floating point registers 

• Program status word 



Press CANCEL 



;The program frame 
; displayed prior to this 
• operation is re-displayed 



Select new frame 



c 



Press START 



J 



When using COPY and ENTER: 

Using COPY will only produce a "hard copy" of lines that have been changed by entering new data. 

Using ENTER in display mode will not produce a "hard copy". 
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Aids provided by the Operator's Console 



INSTRUCTION 
STEPPING 
(ALL MODELS) 



This console facility allows the operator to check and obtain a hard copy of each 
instruction address executed during program operation. 

Combining this facility with the console printer ALTER/DISPLAY feature 
described in D-l of this section, provides a procedure to trace and record the path 
of a short loop. 

Note: The different types of loops and their causes are described in Section 1. 



When to use (all Models) 

This facility should be used when the system malfunction prevents the use of 
SDAIDS to trace the loop. It is also useful during hands-on debugging when only 
small parts of a prograrh require accurate program flow analysis. 

Flowcharts in Section 3 indicate to the operator when a loop is to be traced using 
this console facility. 



INSTRUCTION STEPPING 
MODELS 135, 145, 
AND 155-11 



How to use 



A procedure for tracing and recording the path of a loop using the instruction step 
facility of the Models 135, 145 and 155-11 is shown in the flowchart opposite. 
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Aids provided by the Operator's Console 

INSTRUCTION STEPPING 

MODELS 135, 145, 

AND 115-11 



Start 



Press STOP and wait until 
MAN indicator turns on 



Set RATE switch to 
INSTRUCTION STEP 



Press ALTER/DISPLAY 
(printer-keyboard) and 
wait until PROCEED light 
(printer-keyboard) turns on 



Carrier return and line feed occurs. ALT/DISP 
MODE light (printer-keyboard) turns on. 
If this does not occur, press CANCEL on the 
printer-keyboard, and press the ALTER/DISPLAY 
key again. 




Type in DP 
press END 



The contents of the current PSW 
is printed 




NO 



YES 



Press START and wait until 
SYS indicator turns off 



Set RATE switch 
to PROCESS 



To continue system 
operation, press the 
START key 



The procedure for tracing a loop using instruction step method 
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Aids provided by the Operator's Console 

How to use 



INSTRUCTION STEPPING 
MODELS 115 AND 125 



INSTRUCTION STEP 
offers two modes: 
IandP 



The INSTRUCTION STEP display allows the operator to check and make a note 
of each instruction address during program operation. 

Making a note of the instruction addresses executed each time the START button 
is pressed provides a procedure to trace and record the path of a short loop. 

To select the instruction step display shown below: 

1. Type I into the mode select display. 

2. Press ENTER. 



INSTRUCTION STEP 



OPERATION RATE 

I INSTRUCTION STEP 
P PROCESS 



I INSTRUCTION STEP 



P PROCESS 



.If I is typed into the instruction step display and ENTER is pressed, the new data 
can be seen as soon as the stop occurs. Line 14 (in the machine status area) shows 
the address and the data at this address. 

.As soon as START is pressed the screen is returned to the operating system and 
operating messages can be traced with each step. Instruction step mode is indicated 
by I-STEP on line 15 (in the machine status area). Entering P is used to end the 
instruction step mode. 

1. Type in P. 

2. Press ENTER 

The last picture of the operating system is brought back to the screen. 
Press START to continue processing. 



2 . 1 48 Serviceability Aids . 



Aids provided by the Operator's Console 

INSTRUCTION STEPPING 
MODELS 115 AND 125 



Press MODE SELECT 



Type in II and press ENTER 



The machine stops and the previous 
display disappears 



Press START 
Wait until MAN appears 
on line 13 and l-STEP 
appears on line 14 



When START is pressed, the instruction 
step display disappears and the screen 
is returned to the operating system. 
For each depression of START, one 
machine-language instruction is processed. 
CPU then services any pending 
interruptions before entering manual state. 



Make a note of the 
instruction address and con- 
tents displayed on line 14 



Yes 





No 



Press MODE SELECT 



Type in IP and press 
ENTER 



(Fast Selection) 

Instruction step mode is cancelled. 



To resume processing 
press START 



The procedure for tracing a loop using the instruction step method 
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Aids provided by the Operator's Console 



INSTRUCTION 
STEPPING 
MODEL 158 



The INSTRUCTION STEP display allows the operator to check and make a note 
of, or obtain a "hard copy" of each instruction address during program operation. 

Making a note of the instruction addresses executed each time the START button 
is pressed provides a procedure to trace and record the path of a short loop. 



How to use 

With the manual fram displayed, shown below, after pressing MODE SEL, the 
R-RATE switch must be set to I-STEP by either typing in R2 or by pressing the 
light pen to lozenge ■ 2-I-STEP. The selection is indicated by an arrow displayed as 
shown in the example below. 




The instruction address of the current instruction will be in the address part of 
the PSW displayed on line 25. 

Pressing the START key will cause the CPU to execute the next instruction in 
logical sequence, the address of which will be displayed in the PSW as before. 

In display mode of operation a "hard copy" of the PSW displayed can be obtained 
on the 3213 printer, if attached, by pressing the COPY key or by pressing the 
light pen to lozenge COPY. 

To return to normal CPU processing rate, type in Rl or hold the light pen against 
■ 1 -PROCESS and press MODE SEL followed by START. 
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Aids provided by the Operator's Console 

INSTRUCTION 

STEPPING 

MODEL 158 



c 



Press STOP 



3 



Press MODE SEL 



The MANUAL frame is 
displayed 



Type in R2, or press 
light pen to lozenge 
■ 2-l-STEP 



Press START 



Press COPY 

or press light pen 

to lozenge ■ COPY 



The word SYS will be displayed 
momentarily, and the instruction 
address will be displayed in the 
PSWon line 25 



A "Hard copy" of the frame 
displayed can be obtained on 
the 3213 printer, if attached 



Yes 





No 



Type in R1 or press 
light pen to lozenge 
■ 1 -Process 




Yes 



No 



Press MODE SEL 
or CANCEL 



Select new mode 



C 



Press START 



J 



The procedure for tracing a loop using the instruction step method on the Model 1 58 
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STOP ON ADDRESS 

COMPARE 

(ALL MODELS) 



This facility enables you to stop all system activity at any selected storage address 
during system operation. Two methods are provided on the System/370 that 
enable both hardware and software-controlled stops: 

1 . By using switches on the system control panel 

2. By using the SDAID stop on event facility. 

For the Models 145 and 155-1 1 the system control panel switches enable a stop 
on real or virtual address. 

The Model 115, 125 and 135 have system control panel switches that do not allow 
for a stop on a virtual address. 

Stop on event for all models is described under SDAIDS, Section 2-B-8. A flow- 
chart in Section 2-B-10 shows how to initiate and execute this aid. 



When to use (all Models) 

This facility is a hands-on debugging aid for the programmer, and permits him to 
stop system operations at selected addresses in the program listings. He can use it, 
for example, in conjunction with either the ALTER, DSPLY and DUMP commands, 
or the console ALTER/DISPLAY feature, to change the contents or display 
particular areas of storage at selected addresses in a program. The operator is also 
able to use this facility if, for example, the programmer requests a dump of 
certain storage locations at particular points in a program during execution of 
the program. 



STOP ON ADDRESS 
COMPARE 
MODELS 135, 145, 
AND 115-11 



How to use 

Four switches on the system control panel are used during address compare 
operations: 

• ADDRESS COMPARE CONTROL (Toggle) 

• ADDRESS COMPARE (Rotary) 

• STORAGE SELECT (Rotary) 

• INTERVAL TIMER (Toggle). 

The flowchart opposite shows the procedure for stop on address compare applicable 
to System/370 Models 135, 145 and 155-1 1. However, because the ADDRESS 
COMPARE rotary switch differs between models, the IBM operating procedures 
for the model on which the operation is to be executed must be consulted. 

The flowchart on the following page shows how to invoke the displays required 
to execute the "Stop on Address Compare" on the Models 115 and 125. 
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STOP ON ADDRESS 

COMPARE 

MODELS 135, 145, 

AND 155-11 



Start 



Press STOP 



Ensure STORAGE SELECT 
is set to MAIN STORAGE 



Set INTERVAL TIMER 
to DISABLE 



Set rotary switches A 
through E (STORAGE ADD- 
RESS) to desired stop 



> 



Set ADDRESS COMPARE 
to select desired condition 
for stop, for example, ANY 



Set ADDRESS COMPARE 
CONTROL three-position 
lever switch to STOP 



Press START 



Address 

Comparison 

Stopping 



Switch positions for selecting the 
conditions for the stop are different for 
each of the System/370 Models. Consult 
Compare Type Selection on the next 
two pages and the note below. 



Model 135 and 145 
When address accessed by 
CPU matches selected address 
CPU stops at the end of in- 
struction in progress. 




Set: 

1. ADDRESS COMPARE 
to ANY 

2. ADDRESS COMPARE 
CONTROL to SYNC/ 
NORMAL 

3. INTERVAL TIMER to 
NORMAL (if required) 



Resumption 
v of 
i Normal 

Processing 



Note: 

See ADDRESS COMPARE and 
ADDRESS COMPARE CONTROL 
CONTROL switch setting for each 
System/370 model as described in the 
IBM-supplied Operating Procedures 
manual belonging to the system. 



Press START 



J 



A procedure for using the stop on address compare facility. 
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STOP ON ADDRESS 
COMPARE 
MODELS 135, 145, 
AND 155-11 



Compare type selection (Model 135) 



ADDRESS COMPARE 



ANY 



o|C 




o I/O 



DATA STORE: 

A match occurs when the selected location is addressed to store data. 

ANY: 

The normal operating position — a match occurs when the selected location is 

addressed for any type of operation 

IC: 

; A match occurs when the selected location is addressed by an instruction 

| I/O: 

: A match occurs when the selected location is addressed for an I/O data transfer 



Compare type selection (Model 155-11! 



I ADDRESS COMPARE" 

ANY 
FETCH 0,^1^0 IAR 

STORE ° 




ANY (Real Address) 

This position of the switch is used for normal program processing. With the switch 
in this position, a match occurs for main storage access when the storage address 
matches the address set in console switches CDEFGH. 

FETCH 

This position causes a match when the storage address matches the address set in 
console switches CDEFGH, and the operation is a data fetch from main storage. 

STORE 

This position allows a match when the storage address matches the address set in 
console switches CDEFGH during a data store operation. 

IAR 

This position of the switch allows a match when the IAR (instruction address 
register) address matches the address set in console switches CDEFGH. 

I/O (Input/Output) 

: This position of the switch allows a match when the storage address matches the 
| address set in console switches CDEFGH, and the operation is a data store or fetch 
for an I/O operation. 
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Compare type selection (Model 145) 

ANY (Logical Address) 

This position of the switch allows a match when the logical 
main storage address used to access storage matches the |§§| : 

address set in console switches CDEFGH. 

ANY (Real Address) 

This position of the switch is used for normal program 
processing. With the switch in this position, a match occurs 
for main storage access when the storage address matches 
the address set in console switches CDEFGH. 

DATA STORE 

This position allows a match when the sotrage address 
matches the address set in console switches CDEFGH during 
a data store operation. 

I/O (INPUT/OUTPUT) 

This position of the switch allows a match when the storage 
address matches the address set in conssole switches 
CDEFGH, and the operation is storing or fetching data for 
an I/O operation. 
I-COUNTER (Real or Logical Address) 

This position causes a match when the real or logical main 
storage address matches the address in console switches 
CDEFGH, and the operation is an instruction fetch from 
main storage. 

NOTE: Significant throughput degradation can occur while processing with this 
switch set to the l-COUNTER REAL ADR position. 
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STOP ON ADDRESS 

COMPARE 

MODELS 135, 145, 

AND 155-11 



ADDRESS COMPARE 



ANY 



ANY 
LOGICAL 
ADR 
I COUNTER 

CTRL WORD • 
ADR 
CTRL WORD • 
TRAP 




DATA STOR 



•l/O 



REAL 
ADR 



• I COUNTER 

DATA COMP 
TRAP 



Data compare trap (Model 145) 

This facility is useful during hands-on debugging to determine what instruction is 
causing a particular storage byte location to be modified. 

1. Press STOP. 

2. Set the ADDRESS COMPARE switch to DATA COMPARE TRAP. 

3. Set the address of the storage byte location being modified in console 
switches CDEFGH. 

4. Set data switches A and B to the desired byte match value. 

5 . Set the ADDRESS COMPARE CONTROL toggle switch to STOP. 

6. Press START. 

When a store operation modifies the specified storage byte location to the value set 
in switches A and B, the ADR COMP MATCH indicator is turned on and the CPU 
enters a soft-stop state. 

To determine the address of the instruction that modified the storage byte, display 
the current PSW, and subtract the current instruction length code from the 
instruction address in the current PSW. 

Note: 

The instruction found with this procedure may not have modified the data. An 

I/O data trap occurring during execution of this instruction could have modified 

the data. To determine which I/O data trap modified the data, log the address 

displayed in the A-Register Display roller switch indicators and call your service 

representative. 
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STOP ON ADDRESS 

COMPARE 

MODELS 115 AND 125 



How to use 

Before this facility can be used the mode select display must be brought to the 
screen by pressing the MODE SELECT key. 

To select the storage ADDRESS COMPARE display shown below: 

1. Type in 'C beside MODE SPECIFICATION on the mode select display. 

2. Press ENTER. 



Error Indications 

If you make an error when typing in 
the code or hex characters: 

• The address compare display stays 
on the screen. 

• INVALID CHARACTER appears. 

• The cursor marks the location of the 
first error. 

The display remains on the screen 
as long as an entry error has not been 
corrected. When there is no error, 
the display disappears after ENTER 
is pressed. 



MAIN STORAGE ADDRESS COMPARE 



P PROCESS 



COMPARE TYPE 



D DATA STORE 



I I/O DATA 
C IINJSTR.COUNT 



STORAGE ADDRESS 



000000- FFFFFF 



Three columns are displayed and an entry must be made under each column. 

S STOP: the machine' stops when the address has been found. 

ACTION < y SYNC: a signal for the customer engineer is given when the address has been 
(^ found. 

P PROCESS: address compare mode is turned off and normal processing continues. 

A ANY: the CPU will compare your search address (the address you type into 
column three) against all addresses used in the system. 

D DATA STORE: the CPU will compare your search address against only those 
storage addresses used to store data. 

Your search address will not be compared against addresses used in transferring 
data to or from I/O devices. 

I I/O DATA: the CPU will compare your search address against only those 
storage addresses used in transferring data to or from I/O devices. 

C INSTR COUNT: the CPU will compare your search address against only those 
STORAGE ADDRESS^ addresses used when fetching instructions. 

The real storage address at which the stop is to occur. 



COMPARE TYPE { 
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Press MODE SELECT 



The machine stops and the display 
disappears. 



Type in Cand press 
ENTER 



Type in S (or Y) 



Type in code for type 
of data to be compared 



Type in real storage 
address (6 hex digits) 



Press ENTER 



Processing continues until 
address is found. Then 
System stops. 



Press START 



Make a note of the data 
displayed on line 15 




YES 



Press MODE SELECT. 
Type in CP. 
Press ENTER. 



To resume processing 
press START 



STOP ON ADDRESS 

COMPARE 

MODELS 115 AND 125 



Y is for CE use only. 



Codes are: 
A = ANY 

D = DATA STORE 
I = I/O DATA 
C = INSTR COUNT 



(See the description 
of the codes on the 
opposite page) 



Addresses outside the real address area cause 
message INVALID ADDRESS to be displayed 



Address compare display is replaced but 
specifications entered are displayed on line 14 
of the new display 



; •The last operating message stays on the 

screen. 
; • MAN appears. 
; • The addresses on lines 1 4 and 1 5 are the 

same. 




Stop on Address Compare mode is 
cancelled 



Fast Selection: You can type your specif ications for address compare directly 
into the mode select picture. For example, you can type CSC005FAC, without 
commas of blanks to specify Compare with action Stop during instruction 
fetching with address 005FAC. 
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STOP ON ADDRESS 
COMPARE 
'MODEL 158 

STOP ON A REAL ADDRESS 



COMPARE TYPE 

Note: If STOP is not selected 
a 'sync ' pulse will be generated 
on true comparisons and the 
CPU will not stop. 



How to use 

Before this facility can be used the MANUAL frame must be brought to the screen 

by pressing the MODE SEL key. 

To stop on a real address S-SAR COMP SEL(REAL) must be used in conjunction 
with E-SAR COMP SEL(REAL). 

1 . Select the STOP function ■ 5 -STOP or type in S5 

2. Select the compare type (see below) 

3. Enter a real address at E-SAR COMP SEL(REAL). 

A stop will occur on any quadword boundary of a selected real address 

1-ANY: the CPU will compare the address set under E with all addresses used in the 
real addre ss area. When a true comparison is met the CPU will stop. 
2-STORE: causes the CPU to stop when a STORE operation is performed on the 
location at the address entered under E. 

3-FETCH: causes the CPU to stop when a FETCH operation is performed on the 
location at the address entered under E. 
^ 4-1/0: causes the CPU to stop when data is transferred either to or from the 
location at the address entered under E. 

The example below shows the appearance of the manual frame after selecting a 
stop on a FETCH operation on the location at real address 007FF8. 



STOP ON A VIRTUAL 
ADDRESS AND DATA 
COMPARE TRAP 




A facility on the System/370 Model 158 allows a stop on a virtual address with a 
maximum of 6 conditions described in the table below. 



FUNCTION 


CPU ACTION 


USAGE 


G1 -STORE 
G2-IAR 


Stops processing after a store to the virtual address specified 
in ADR1. 

Stops processing after an instruction fetch to the virtual 
address specified in ADR1. 


The cursor can be backed up under the digit to the left of the 
period and the base register entered in that position. The six 
digits to the right of the period are used to contain the dis- 
placement. The DATA fields and the ADR2 and ADR3 fields 
can be used to further define the stop conditions, giving a 
maximum of six conditions that must be satisfied before a 
stop occurs. The C to the left of the period in the data field 
signifies that the specified data will be compared. When the 
C is changed to a 1 , the specified bits are compared. 

Example: If the character to the left of the period is changed 
to a 1, and 7 A is entered in the DATA field, a stop occurs 
whenever bits 3, 4, and 6 are on. Conversely, if the C is 
changed to a 0, a stop occurs whenever bits 3, 4, and 6 are 
off. 


H1-ADR1 
H2-DATA 


Specifies the first condition that must be met in order for 
a stop to occur. 

Specifies the data that must be found at the address in 
ADR1 for a stop to occur. If DATA is not pressed, the stop 
occurs whenever the location specified by ADR1 is 
addressed. 


H3-ADR2 
H4-DATA 


Specifies additional conditions that must be met if a stop 
is to occur. 


H5-ADR3 
H6-DATA 


Specifies additional conditions that must be met if a stop 
is to occur. 
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Press STOP 



STOP ON ADDRESS 

COMPARE 

MODEL 158 



Press MODESEL 



Type in S5 or press 
light pen to lozenge 
■ 5-STOP 



|The manual frame will be displayed 



| If STOP is not selected, a sync pulse 
|only is generated on true comparison 
If or use by the IBM CE 



Type in a code number 
or use the light pen, to 
specify the type of 
compare required 



Type in a six digit 
addresss in hexadecimal, 
or use the light pen at HEX 
INPUT on the display. 



Press ENTER or COPY 



Processing continues 
until address is found. 
Then System stops. 



Press START 




Yes 



Press CANCL 



To resume processing 
press START 



| Codes are: . 

11-ANY J [ see the description 
|2-STOReI J of the codes under 
J3-FETCHM COMPARE TYPE 
|4-l/0 I Ion the opposite Page. 



^The address will be displayed as 
I it is entered at E-SAR COMP 
I SET (REAL) The address 
I specified must be within the 
\ real address area 



I Using Copy will cause the entire 
\ manual frame to be printed on 
ithe 3213 printer 



\ The word MAN will be 
| displayed at the lower right 
i corner of the display 



The manual frame is replaced 
by the program frame 
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CONSOLE DUMP 

OPERATION 

MODELS 115 AND 125 ONLY 



This operation provides a non-destructive readout and printout of any real storage 
area (up to 64K bytes at a time). The command can be executed at any time, and 
the (dumped) program can continue as soon as dumping is completed (no IPL or 
restart required). 
To select the storage dump display: 

1. Type D into the mode select display. 

2. Press ENTER. 

The display shown below appears on the screen. 



Error Indications'. 

PRINTER NOT READY appears 
if the line printer is not ready. 
STORAGE END appears if the 
start address is greater than the 
physical size. 

INVALID CHARACTER appears 
for any non-hex digits. 
INCOMPLETE ENTRY appears 
when necessary. 



MAIN STORAGE DUMP 



ENTER START ADDRESS: 00 03 00 
END ADDRESS: ** 12 FF 



STORAGE END 



How to use 

1. Type in the start and end addresses. Remember that: 

• The low order halfword must be two zeros. 

• The end address must be within 64K bytes from the start address, and the 
low-order halfword must be FF. 

• If the dump required is more than 64K bytes, repeat the operation with 
a new start and end address. 

2. Press ENTER. 

• Dumping can be stopped at any time by pressing MODE SELECT, CANCEL, 
or START. If one of these keys is pressed, DUMP CANCELLED appears on 
the screen. 

• DUMP COMPLETE appears on the scrren when the selected dump range has 
been printed. 

• STORAGE END appears on the screen when the upper boundary of storage 
has been reached. 

The flowchart shown on the opposite page shows the procedure for using this 
command. 



When to use 

This is a useful aid to use when large areas of real storage must be recorded for 
later analysis. It can also be used instead of the ALTER/DISPLAY feature to 
record low address storage before executing the stand-alone dump program. 
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Press MODE SELECT. 
Type in D. 
Press ENTER. 



CONSOLE DUMP 

OPERATION 

MODELS 115 AND 125 ONLY 



Ready the 
Line printer 



Enter the starting and 
ending addresses in hex 



Press ENTER 



The end address cannot be 
more than 64K from the start 
address 



Dumping begins 




YES 



I 



Press MODE SELECT 
CANCEL, or START. 



DUMP CANCELED 
is displayed 



Press CANCEL 



The dump display disappear. 



To resume processing 
Press START 



Processing continues 



NOTE: If a log or retry operation takes place at the same time as a 
dump request, PRESS CANCEL appears on the screen. After pressing 
CANCEL, the message LOG IN PROGRESS appears in the machine 
status area. You can repeat clumping as soon as the log message 
disappears. 



D-10-F 
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STORE STATUS 
(ALL MODELS) 



This function enables certain control information to be stored and preserved for 
analysis by the IBM CE. 

Models 135, 145 and 155-11 

1. Press the console printer keyboard ALTER/DISPLAY key. 

2. Type in ST. 

The information saved is identical to that listed below for the Model 125 

Models 115 and 125 

There is no display for STORE STATUS. 
To store the status: 

1. Type S into the mode select display. 

2. Press ENTER. 



0-OPERATOR FUNCTIONS 
1-PSW RESTART(PRGM) 
2-RESTART(PRGM) 
3-SYSTEM RESET 
4-LOAD 

5-STO RE STATUS 
6-SYS REST(CLEAR) 
7-LOAD(CLEAR) 



I- 


LOAD UA 
000 


W- 


-SWAP 
SAR 13 


X 


-EXECUTE 
OPERATOR FUNCTION 



The following information is stored. 

• CPU Timer 

• Clock Comparator 

• The current PSW 

• Floating-Point Registers 

• Control Registers 

• General Registers. 

After ENTER has been pressed: 

• The mode select display remains on the screen and STATUS STORED appears. 

• The system goes into the stopped state. 

• The S has disappeared from the mode specification field, so this field is free 
and another operation can be specified. 

Note: This function must not be used on a Model 115 or 125 that does not support 
MCH (Machine Check Handling). 

^Model 158 

1. Press MODE SEL to obtain the manual frame. 
' 2. Type in 03 or hold light pen against ■ 3-SYSTEM RESET. 

3. Type in X or press light pen to lozenge ■ OPERATOR FUNCTION. 

4. Type in 05 or press light pen to lozenge ■ 5-STORE STATUS. 
} { 5. Type in X or use light pen at ■ OPERATOR FUNCTION. 

A new function may now be selected. 

When to use 

This function should be used before executing the stand-alone dump program. 
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Models 135, 145 and 155-11 

Real storage can be cleared to zeros by the following procedure: 

1 . Press and hold in ENABLE SYSTEM CLEAR. 

2. Press SYSTEM RESET or LOAD. 

3. Re-IPL to continue processing new job. 
Note: Control storage is unaffected. 



Aids provided by the Operator's Console 

CLEAR REAL STORAGE 
(ALL MODELS) 



Models 115 and 125 

1. Press the MODE SELECT key. 

2. Type RC into the mode select display. 

Note: AtlPL time one of the LOAD parameters is NORMAL or CLEAR 

Model 158 

Two methods are available on the Model 158 to clear real, or main storage. 



1. 



System Reset (Clear): In addition to performing the reset function, this causes 
main storage and the storage-protect arrays to be validated (cleared to zeros with 
good parity). 

Press MODE SEL to obtain the manual frame. 

Type in 06 or hold light pen against ■ 6-SYS RESET (CLEAR). 

Type in X or hold light pen against ■ OPERATOR FUNCTION. 



2. Load (Clear): In addition to performing the load function, this causes the IPL 
function to be preceded by an initial program reset, and clears main storage and 
the storage-protect arrays. 

• Press MODE SEL to obtain the manual frame 

• Enter a load unit address 

• Type in 07 or hold the light pen against ■ 7-LOAD (CLEAR). 

• Type in X or use light pen at ■ OPERATOR FUNCTION. 

When to use 

This facility should be used with caution. An example of Its use is to reset the 
hardware after a machine check is caused by a parity error in real storage. It must 
be used after you have gathered all the information from the system. 
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SAVE USAGE COUNTERS 



There is no display for SAVE USAGE COUNTERS. 
To select the save usage counters operation: 

1 . Type U into the mode select display. 

2. Press ENTER. 

When to use 

This operation saves the usage counters of all disk drives. The operation should 
always be performed before you turn the power off so that the information can be 
used by the CE for maintenance. The message 'counter saved' appears for each 
counter that is recorded. 
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JOB CONTROL 
COMMANDS AND 
STATEMENTS 



The following commands and statements are not primarily designed as 
serviceability aids, but enable useful information to be obtained from the system 
during program execution. 

For example, it is useful to place the LISTIO statement and command in job 
streams where device assignments are suspected of causing errors. The LOG 
command enables you to record job control statements and commands issued 
during a job, and the MAP command enables you to check partition allocation. 
These three commands, LISTIO, LOG, and MAP can be used therefore as a "job 
stream trace," as shown in the example opposite. 

In certain cases of system malfunctions, this information, used in conjunction with 
dumps and trace routine output, will help during offline debugging. 



LISTIO or //LISTIO 

The LISTIO command or statement (List I/O Assignment) causes the system to 
print a listing of I/O assignments. The listing appears on SYSLOG (command) or 
SYSLST (statement). If SYSLST is not assigned, the LISTIO statement is ignored. 



Statement Format 



II LISTIO 



SYS 

PROG 

BG 

F4 

F3 

F2 

F1 

ALL 

SYSxxx 

UNITS 

DOWN 

UA 

X'cuu' 



— (output on SYSLST) 



Command Format 



LISTIO 



SYS 

PROG 

BG 

F4 

F3 

F2 

F1 

ALL 

SYSxxx 

UNITS 

DOWN 

UA 

X'cuu' 



— (output on SYSLOG) 



The table following the example opposite explains the meaning of the LISTIO 
options. 



2.166 Serviceability Aids. 



Other Aids 

JOB CONTROL 

COMMANDS AND 

STATEMENTS 





An example of a "job stream trace" using the LOG, MAP, LISTIO and PAUSE 
commands and statements. 
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JOB CONTROL 
COMMANDS AND 
STATEMENTS 



Options for LISTIO 



Options 


Meaning 


SYS 


Lists the physical units assigned to all system logical units. (See note.) 


PROG 


Lists the physical units assigned to all background programmer logical units. (See note.) 


BG 


Lists the physical units assigned to all background logical units. 


F4 


Lists the physical units assigned to all foreground-one logical units. 


F3 


Lists the physical units assigned to all foreground-two logical units. 


F2 


Lists the physical units assigned to all foreground-three logical units. 


F1 


Lists the physical units assigned to all foreground-four logical units. 


ALL 


Lists the physical units assigned to all logical units. 


SYSxxx 


Lists the physical units assigned to the logical unit specified. The assignment is given for the partition from 
which the command is given. (See note.) 


UNITS 


Lists the logical units assigned to all physical units. (See note.) 


DOWN 


Lists all physical units specified as inoperative. (See note.) 


UA 


Lists all physical units not currently assigned to a logical unit. 


X'cuu' 


Lists the logical units assigned to the physical unit specified. 



Note: Physical units are listed with current device specification for magnetic tape units. Logical units are listed with ownership 
(background, or any foreground), when applicable. If a unit has a standard assignment in one mode and a temporary assignment 
in another mode, the CMNT column identifies the type of assignment for each indicated mode. All channel unit numbers are 
represented in hexadecimal. 

LOG 

The LOG job control command causes the system to log, on SYSLOG, columns 
1-72 of all Job Control commands and statements occurring in the batched-job 
partition in which the LOG is issued. The AR LOG affects all the partitions. The 
LOG function is effective until a NOLOG command for the partition involved is 
sensed. 

The format for the LOG job control command via attention routine is as follows: 
LOG blank 

The operand field is ignored by the system. 

NOLOG 

The NOLOG command (suppress logging) terminates the listing, on SYSLOG, of 
Job Control commands and statements (except JOB, PAUSE, STOP, ALLOC, 
MAP, HOLD, RELSE, UNA, DVCDN, DVCUP, *, and /&) that occur in the 
batched-job partition in which the NOLOG is issued. The NOLOG function is 
effective until a LOG command for the partition involved is sensed. 

The format for the NOLOG job control command via attention routine is as 
follows: 

NOLOG blank 

The operand field is ignored by the system. 
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MAP command 

The MAP command produces on SYSLOG a map of virtual storage areas allocated 
to programs. 

An example of the output produced on the console printer is shown below: 



Other Aids 

JOB CONTROL 

COMMANDS AND 

STATEMENTS 



























T2 


map 
















• 


1-2 

: F2 


AREA K- 


-REAL 


UPPER LIMIT 


K-VIRT 


UPPER LIMIT 


NAME 








F2T 


SP 1 


92K 


94207 




262144 








• 


1-2 


BG V5A 


30K 


124927 


292K 


561151 


KENSLOOP 






]F2 


F4 14 


10K 


135167 


80K 


643071 










F2 


F3 13 


10K 


145407 


80K 


724991 








• 


F2 


F2 V2A 


14K 


159743 


100K 


827391 


NO NAME 






F2 


Fl 11 


82K 


243711 


120K 


950271 










F2 


SVA 






96K 


1048575 








• 


!F2 


VIS 






68K 


1048575 








F2 


PP 


18K 


262143 






^^^^£*S9K1 




























SP = Supervisor, V = Virtual, PP = Main Page Pool, 1 = Inactive, SVA = Shared Virtual Area, R = Real, 
A = Active 

1, 2, 3, 4, 5 = Partition Priority (1 = highest priority), VIS = Amount of SVA reserved by GETVIS 
parameter of the VSTAB system generation macro 


K-REAL 


gives the number of bytes allocated to the real partition or the number of bytes of the main page pool. The size 
is given in multiples of 2K. 


UPPER LIMIT 


shows the highest storage addresses in decimal of the respective real partition, of the supervisor, and of the main 
page pool. 


K-VIRT 


specifies the number of bytes allocated to the respective virtual partition. The size is given in multiples of 2K. 
This field is blank for the supervisor and for the main page pool. 


UPPER LIMIT 


contains the highest storage address in decimal of the respective virtual partition. For the supervisor, this field 
specifies the start address of the virtual address area. This field is blank for the main page pool. 


NAME 


contains the name of the job which is currently executing in the corresponding partition. This field is blank for 
the supervisor, SVA, VIS, and for the main page pool. When the listing shows NO NAME for the background, 
or when the name field is blank for a foreground partition, no program is being executed in that area. However, 
the name field for any partition contains NO NAME when no job control statement or command was entered, 
but the program is active. 



Note: If a program issues an SVC55, some page frames in the main page pool (PP) will also belong to that program. Therefore to calculate 

the total area in real storage occupied by that program, the MAP command should be issued before running it. The difference between 

the number of K in the PP before running the program, and the number of K during the execution of the program is the amount of K 

seized by the SVC55. 

This also applies when PDAID output mode is an alternate area or the SDAID is initiated. 

In this case, the area occupied by the PDAID or SDAID is printed during their initialization. 

Note: The output does not indicate storage temporarily added to the page pool as a result of using the SIZE parameter of the 
EXEC statement. 
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OPTION 

The OPTION statement specifies one or more of the Job Control options. The 
format of the OPTION statement is: 

JCS Format 

//OPTION option 1 (,option2,...) 

The options that can appear in the operand field follow. Selected options can be 
in any order. Options are reset to the standards established at system generation 
time upon encountering a JOB or a /& statement. 

DUMP Causes a dump of the registers and main storage to be output on 

SYSLST, if assigned, in the case of an abnormal program end. (See 
A -2 in this section for a full description.) 

NODUMP Suppresses the DUMP option, if the latter was specified in the STDJC 
macro during system generation. 

LOG Causes the listing of columns 1-80 of all control statements on 

SYSLST. Control statements are not listed until a LOG option is 
encountered. Once a LOG option statement is read, logging continues 
from job-step to job-step until NO LOG option is encountered or until 
either the JOB or /& control statement is encountered. 

NO LOG Suppresses the listing of all valid control statements on SYSLST until 
a LOG option is encountered. If SYSLST is assigned, invalid 
statements and commands are listed. 

LIST Causes language translators to write the source module listing on 

SYSLST. In addition, it causes the Assembler to write the hexadecimal 
object module listing and causes the Assembler and the FORTRAN 
compiler to write a summary of all errors in the source program. All 
are written on SYSLST. 



NOLIST Suppresses the LIST option. 



PAUSE 



The PAUSE command causes a pause at the end of the current job step. The 
PAUSE Job Control statement causes a pause immediately after processing this 
statement. At the time, SYSLOG is unlocked for message input. END (on the 
Models 135 and 145) or ENTER (on the Model 125) causes processing to continue. 
The PAUSE statement or command always appear on SYSLOG. If a 3210 or 3215 
or video console display unit is not available, the PAUSE statement or command 
is ignored. 
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This is an area of real storage, starting at byte address 000000, and permanently 
reserved for use by the supervisor. 

For the purpose of program debugging, low address storage extends up to byte 
address 160 decimal (X'BF') 



Other Aids 

LOW ADDRESS 
STORAGE 



Displaying low address storage 

Low address storage will always be dumped during the execution of: 

• A stand-alone dump; see A-2 in this section. 

• A system dump; see A-2 in this section. 

• A transient dump (bytes 0-144 hex); see A-4 in this section. 

Low address storage can also be dumped by means of DUMP or DSPLY operator 
commands (see A-l in this section), or the ALTER/DISPLAY feature on the 
console printer or display unit keyboard (see D-l in this section). 




When to display 

• Low address storage must be dumped by using the ALTER/DISPLAY 
console printer feature whenever a hard wait is recognized. 

• When a system malfunction is recognized in one of the programs in a 
multiprogramming or teleprocessing environment, low address storage must 
be dumped by using the DUMP or DSPLY commands in order to avoid total 
system collapse. 

Flowchart D-l-F in this section shows how to dump low address storage by using the 
ALTER/DISPLAY feature on the console printer. Flowcharts in Section 3 indicate 
when to dump low address storage. 



CAW (Channel Address Word) 

The CAW specifies the storage protection key and the address of the first channel 
command word associated with the START I/O instruction. The CAW is found at 
hex location 48. 



KEY 


0000 


Channel Command Word Address 



31 



Note: After the execution of any dump program, the information in the CA W is 
unreliable. In this case, the start address of the CCW is found in the command 
control block (CCB). 

Locating CCBs is described in Section 4. 
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CSW (Channel Status Word) 

The CSW informs the program of the status of an I/O device or the conditions 
under which an I/O operation has been terminated. The CSW is formed, or parts 
of it are replaced, during I/O interruptions and during execution of I/O 
instructions. The CSW is placed in low address storage at location hex 4Q. It is 
available to the program at this location until the next I/O interruption occurs or 
until another I/O instruction generates a new CSW, whichever occurs first. When 
the CSW is stored as a result of a START I/O instruction, the I/O device is 
identified by the I/O address in the old PSW. The information placed in the CSW 
by an I/O instruction pertains to the device addressed by the instruction. 

The CSW format is shown below. 



Key 





L 


1 

CC 

1 


Channel Command Address 


Unit Status 


Channel Status 


Count 1 







4 






8 


32 


40 


48 


63 



Bits 0- 3 


Protection key used in the last operation 


Bit 5 


Reserved 


Bits 6- 7 


Deferred condition code 


Bits 8-31 


Address plus 8 of the last CCW used 


Bits 32-39 


contain the unit status byte: 




Bit 32 — attention 




Bit 33 — status modifier 




Bit 34 — control unit end 




Bit 35 — busy 




Bit 36 — channel end 




Bit 37 — device end 




Bit 38 — unit check 




Bit 39 — unit exception 


Bits 40-47 


contain the channel status byte: 




Bit 40 — program-controlled interruption 




Bit 41 — incorrect length 




Bit 42 — program check 




Bit 43 — protection check 




Bit 44 — channel data check 




Bit 45 — channel control check 




Bit 46 — interface control check 




Bit 47 chaining check 


Bits 48-63 


Residual count of the last CCW used 



Note: After the execution of any dump program, the information in the CSW is 
unreliable. In this case, CSW information is found in the command control block 
(CCB). 

Locating CCBs is described in Section 4. 
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PSW (Program Status Word) 

The PSW contains information required for the program execution. By storing the 
PSW, the control program can preserve the status of the CPU for later inspection. 
By loading a new PSW or part of a PSW, the status of the CPU can be changed. 

The format of old and new PSWs is the same as that of the current PSW, shown 
below : 



LOW ADDRESS 
STORAGE 



u 


R 


U 


U 





T 


1 


E 


Protection 
key 


1 


M 


W 


P 


U 


U 


C 


C 


Program 
mask 


Unassigned 


Reserved 


^\ Instruction v^ 
J) address JJ 



















8 










16 








20 


24 


33 


40 63 



U indicates the bit is unassigned. 

indicates the bit is set to zero. 

1 indicates the bit is set to one. 



PROGRAM EVENT RECORDING MASK 
(Bit 1 >. 


If ON, permits interruptions subject to the program-event control bits in control 
register 9. 


TRANSLATION MODE (Bit 5). 


If ON, invokes the dynamic address translation (DAT) services. 


I/O MASK (Bit 6). 


It ON, enables I/O interruptions subject to the channel mask bits in control 
register 2. 


EXTERNAL MASK (Bit 7). 


If ON, enables external interruptions subject to the corresponding external 
sub-class mask bits in control register 0. 


PROTECTION KEY (bits 8-1 1 ). 


Is compared with a storage key whenever a result is stored, or information is 
fetched from a protected location. 


EXTENDED CONTROL MODE INDICATOR 
(Bit 12). 


If ON, indicates that the supervisor operates in Extended Control (EC) model. 


MACHINE CHECK MASK (Bit 13). 


If ON, enables machine check interruptions resulting from system damage or 
instruction-processing damage; other machine check interruptions are enabled 
subject to the sub-class mask bits in control register 14. 


WAIT STATE (Bit 14). 


If ON, indicates that the CPU is in the Wait State. 


PROBLEM STATE (Bit 15). 


If ON, indicates that the CPU is in the Problem State; if OFF, the CPU is in the 
Supervisor State. 


CONDITION CODE (bits 18-19). 


Is set as the result of the execution of certain instructions. 


PROGRAM MASK (Bits 20-23) 


comprises: 

Fixed-Point Overflow Mask 

Decimal Overflow Mask 

Exponent Underflow Mask 

Significance Mask. 

A Mask bit ON enables an interruption when the specified exception occurs. 

The Significance Mask bit also determines the manner in which floating-point 

addition and subtraction are completed. 


INSTRUCTION ADDRESS (Bits 40-63). 


For all PSWs, the address is that of the next logical instruction. In addition, for 
the new PSWs the address points to the routine that handles the particular 
interrupt, and for the old PSWs it contains the return address in the 
calling routine. 
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Displacement 
in hexadecimal 


Description (all numbers referenced are in hexadecimal) . 


0-7 


The field is used for the following two functions: 

Restart New PSW: The new PSW is fetched from locations 0-7 during the restart operation. 

IPL PSW: The first eight bytes read during the IPL initial read operation are stored at locations 0-7. The 

contents of these locations are used as the new PSW at the completion of the IPL operation. These locations 

may also be used for temporary storage at the initiation of the IPL operation. 


8-F 


The field is used for the following two functions: 

Restart Old PSW: The current PSW is stored as the old PSW at locations 8-F during the restart operation. 
IPL CCW1 : Bytes 8-F read during the IPL initial read operation are stored at locations 8-F. The contents of 
these locations are ordinarily used as the second CCW in an IPL CCW chain after completion of the IPL initial 
read operation. 


10-17 


IPL CCW2: Bytes 10-17 read during the IPL initial read operation are stored at locations 10-17. The contents 
of these locations may be used as the third CCW of an IPL CCW chain after completion of the IPL initial read 
operation. After IPL bytes 14-17 contain the address of the background partition communication region. 
Thereafter they contain the address of the communication region for the active partition. (Communication 
regions are described in Section 4). 


18-3F 


Interruption Old PSWs: The current PSW is stored as the old PSW at locations 18-1 F, 20-27, 28-2F, 30-37, and 
38-3F during the external, supervisor-call, program, machine-check, and input/output interruptions, 
respectively. 


40-47 


CSW : The channel status word (CSW) is stored at locations 40-47 during an I/O interruption. It, or portions 
thereof, may be stored during the execution of START I/O, START I/O FAST RELEASE, TEST I/O, HALT 
I/O, or HALT DEVICE, in which case condition code 1 is set. 


48-4B 


CAW: The channel address word (CAW) is fetched from locations 48-4B during the execution of START I/O 
and START I/O FAST RELEASE. 


4C-4F 


Save area for job duration measurement when the interval timer location is being used by the supervisor 
IT option routines. 


50-53 


Interval Timer: Locations 50-53 contain the interval timer. The timer is updated whenever the CPU is in the 
operation state. Depending on the resolution of the timer, the low-order locations may not be updated. 


54-57 


Contain the time of day. 


58-7 F 


Interruption New PSWs: The new PSW is fetched from locations 58-5F, 60-67, 68-6F, 70-77, and 78-7F 
during the external, supervisor-call, program, machine-check, and input/output interruptions, respectively. 


80-83 


The address of the system communication region, described in Section 4. 


84-87 


External-interrupt Code: During an external interruption in the EC mode, the interruption code is stored at 
locations 86-87 and zeros are stored at locations 84-85. 


88-8B 


SVC-lnterrupt Code: During a supervisor-call interruption in the EC mode, the instruction-length code is stored 
in bit positions 5 and 6 of location 89, and the interruption code is stored at locations 8A-8B. Zeros are stored 
at location 88 and in the remaining bit positions of 89. 


8C-8F 


Program Check Interrupt Code: During a program interruption in EC mode the instruction-length code is 
stored in bit positions 5 and 6 of location 8D, and the interruption code is stored at locations 8E-8F. Zeros 
are stored at location 8Cand in the remaining bit positions of 8D. 


90-93 


Translation-Exception Address: During a program interruption due to a segment-translation exception or a 
page-translation exception, the translation-exception address is stored at locations 91 -93, and zeros are stored 
at location 90. 


94-95 


Monitor-Class Code: During a program interruption due to a monitor event, the monitor-class number is 
stored at location 95, and zeros are stored at 94. This field can be stored in either the BC or EC mode. 


96-97 


PER-lnterrupt Code: During a program interruption due to a program event, the program-event-recording 
(PER) code is stored at location 96, and zeros are stored at 97. This field can be stored only when the 
instruction causing the PER condition was executed under the control of a PSW specifying the EC mode. 


98-9 B 


PER Address: During a program interruption due to a program event, the program-event-recording (PER) 
address is stored at locations 99-9B, and zeros are stored at location 98. 

This field can be stored only when the instruction causing the PER condition was executed under the control 
of a PSW specifying the EC mode. 


9C-9F 


Monitor Code: During a program interruption due to a monitor event, the monitor code is stored at locations 

9D-9F, and zeros are stored at location 9C. 

This field can be stored in either the BC or EC mode. 



Table E-2 Format and contents of low address storage. 



2.174 Serviceability Aids. 



Other Aids 

WAIT STATE 
MESSAGES 



Bytes - 3 of low address storage are used to store and record coded messages 
when a system malfunction occurs during IPL. Other occasions when coded 
messages are stored in these bytes are described below under "Wait states during 
problem program execution." 

Whenever a wait state occurs, it is imperative that these low address storage bytes 
are dumped by using the console printer ALTER/DISPLAY feature , described in 
D-l of this section. 

The table below lists all the coded wait state messages: 



BYTEO 


BYTE 1 


BYTE 2 


BYTE 3 


EXPLANATION 


MCH/CCH/IPL Hard Wait Codes placed in low address storage 


X'CV 


X'E2'(2) 


A, I, S(1) 


Not used 


Irrecoverable machine check. 


X*C2' 


X'E2'(2) 


Not used 


Not used 


Irrecoverable channel failure during RMS fetch. 


X'C3' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure on SYSLOG when RMS message scheduled. 


X'C4* 


X'E2'(2) 


A, I, SO) 


Not used 


No ECSW stored 


X'C5' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure: ERPBs exhausted. 


X'C6' 


X'E2'(2) 


A. I. SO) 


Not used 


Channel failure; two channels damaged or a damaged channel situation occurred while RMS 
was executing an I/O operation. 


X'CV 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; system reset was presented by a channel. 


X'C8' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; system codes in ECSW are invalid. 


X'C9' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; channel address invalid. 


X'D1* 


X'E2'(2) 


A, I, SO) 


Not used 


Irrecoverable channel failure on SYSVIS. 


X'07' 


X'E6' Channel 


Unit or 


IPL I/O error or equipment malfunction; condition code 2 during STIDC instruction. 








X'OO' 


Channel and unit indicate whether device in error is SYSRES or communication device. 
When byte 3 = X'OO', byte 2 indicates the channel for which STIDC instruction was 
issued. Re-IPL system. 


SDAID Hard Wait Code 


X'61' 


X'E6'(3) 


Channel 


Unit 


Another device is running in burst mode on same channel as SDAID output device. 
Re-IPL system. 


SDAID Soft Wait Code 


X'62' 


X'C5* 


Not used 


Not used 


SDAID output device became unready. Make printer ready and press the EXTERNAL 
INTERRUPT key. 


X'OO' 


X'OO' (3) 


X'OO' 


X'OO' 


SDAID Stop on Event. Press EXTERNAL INTERRUPT key to 
continue operations. 


The folic 


iwing Hard Wait Codes are placed in general register 1 1 X'B' as well as in low address storage. 


X'OO' 


X'OO' 


X'OF' 


X'FF' 


Program Check in Supervisor. 


X'OO' 


X'OO' 


X'OF' 


X'FE' 


I/O error during fetch from System CIL. 


X'OO* 


X'OO' 


X'OF' 


X'FD' 


•Channel Failure if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FC 


Machine Check if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FB' 


Page Fault in Supervisor routine with identifier RID X'OO'. 


X'OO' 


X'OO' 


X'OF' 


X'FA' 


Translation Specification Exception 


X'OO' 


X'OO' 


X'OF' 


X'F9' 


Error on Paging I/O. 


X'OO' 


X'OO' 


X'OF' 


X'F8' 


CRT phase not found. 


X'OO' 


X'OO' 


X'OF' 


X'F7' 


No copy blocks available for BTAM appendage I/O request. 


X'OO' 


X'OO' 


X'OF' 


X'F6' 


$MAINDR canceled during system CIL update. 

If this occurs, the system CIL is only partially updated and must be restored before use. 
This hard wait condition can also occur if the FETCH QUEUE BIT (FCHQ) is set in the 
linkage control byte in the partition communication region owned by the 
terminating partition. 


Device E 


rror Recovery Soft Wait Codes placed in low address storage. 


X'08' to 


X'CI'or 


Channel 


Unit 


Error recovery messages. Refer to OP messages in DOS/VS Messages. 



Notes: 1. A (X'CV) = SYSREC recording unsuccessful. 
I (X'C9') = SYSREC recording incomplete. 
S (X'E2') - SYSREC recording successful. 

2. S(X'E2') - Run SEREP. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of the wait PSW. 

Table E-3 Wait State codes 
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Wait states during IPL 

If the system enters the wait state during an IPL procedure and no message is 
printed on SYSLOG, the operator should record at least the first five bytes of low 
address storage. The IPL error message number and action code are displayed in 
hex in these bytes. For example: 

Message Oil 1 A appears in low address storage bytes 0-4 as 

F0C9F1F1C1 

The operator should look up this message in DOS ] /VS Messages and perform the 
indicated action, except for the messages noted below. 



WAIT STATE 
MESSAGES 


















^^T^^V- 



Sh* 



%v? s 






^ 



>)0- 



/PZ. error messages 

If there is an equipment malfunction during IPL, or the IPL cannot be loaded, an 
IPL error message is placed in bytes 0-3. In this state all interrupts are disabled, 
and you must repeat IPL after dumping low address storage, as shown in 
flowchart D-l-F in this section. 



ByteO 


Bytel 


Byte 2 


Byte 3 


Meanings: 


X'07' 


X'E6' 


Channel 


Unit or 
X'OO' 


IPL input/output error: 

• I/O error on SYSRES o] 

• I/O error on communication device (see notes 1 and message X'F0C9F0F1' 
below) 

• Equipment malfunction during the STORE CHANNEL ID instruction 
(see note 3) 

• Supervisor entry not found. 


X'FO' 


X'C9' 


X'FO' 


X'FO' 


This code indicates that less than 16K of real storage is left for problem 
programs. Check that the correct disk volume is mounted on the device 
assigned to SYSRES and re-IPL. If the error recurs, the system programmer 
must check the allocations of real partitions specified in the supervisor to 
be used, and check that at least 16K of real storage is available for execu- 
tion of problem programs running in virtual mode. 


X'FO' 


X'C9' 


X'FO' 


X'FT 


If a card reader has been assigned to SYSRDR during system generation 
and is to be the IPL communication device, press the INTERRUPT key. 

If a card reader has not been assigned to SYSRDR during system generation 
and yet it is to be the IPL communication device, simply READY the 
reader. 


X'FO' 


X'C9' 


X'FO' 


X'F2' 


This code means that the supervisor requested can not be found. 
Check that the correct disk volume is mounted on the device assigned to 
SYSRES. If it is correct, re-IPL and specify a different supervisor when 
message 0I03A is issued and press the END/ENTER key, or press END/ 
ENTER key only, to load the standard supervisor. (If possible contact 
the system programmer and check which supervisor to use.) 


X'FO' 


X'C9' 


X'F1'- 
X'F2' 


X'FO'- 
X'F8' 


Refer to messages 01 100A - 0128A in DOS/VS Messages in the 
DOS/VS Messages manual 




Note 1: When the IPL procedure reaches the normal IPL wait state, and the IPL 
communication device is to be SYSLOG, press the REQUEST key on 
the console printer keyboard. 

Note 2: When byte = X'OO', byte 2 indicates the channel for which the STIDC 
instruction was issued. 
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Wait states during program execution 

Three conditions will place a coded message in low address storage during program 
execution: 

• I/O device error 

• Hardware failures 

• Unrecoverable I/O error during FETCH. 

1 . I/O device error messages. 

Device Error Recovery Messages. 

The example below shows the information that is placed in low address storage 

bytes hex 0-3 when a wait state is caused by an I/O device error, and both 

SYSLOG and SYSLST are inoperative, or SYSLOG is not assigned. 

An example of a coded device error recovery message as it is stored in the low 

address storage is shown below: 

0P08A INTERV'REQSYSLST=00E 

An example of a device error recovery message is shown below: 




Refer to OP messages in DOS/VS Messages, 



ByteO 


Byte 1 


Byte 2 


Byte 3 


X'08' to 
X'60' 


Action 
indicator 
'C1 ' - 'C4' 


Channel 


Unit 



If this condition occurs, the operator must dump, or display and note, bytes 0-3 
of low address storage, and inspect the contents of byte 0. This byte contains a 
hex number that corresponds to an OP message listed in DOS/VS Messages. 

Before proceeding with system operation, the operator will have to decide whether 
to continue system operations with the program currently running or to CANCEL 
all jobs and repeat IPL. This decision depends on system commitments and the 
importance of other programs that are running. 

To continue operations, the operator must first inspect the contents of byte 1 
for the presence of a hex CI or C4. The flowchart opposite shows what further 
actions can be taken under these conditions, and a flowchart in Section 3 indicates 
to operators when this procedure may be required. 
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From Chart 03 
Section 3. 



WAIT STATE 
MESSAGES 



Byte 1 contains X'CV 



Byte 1 contains X'C4' 



Inspect bytes 2 and 3 
Byte 2 indicates the channel, 
byte 3 indicates the unit. 



Insert X'01' (RETRY) 
in byte 4, and press the 
INTERRUPT key 




Yes 



Either; 

Perform any manual recovery procedures 

implied by the error conditions. 

(Refer to component description and operating 

procedures manual for the device.) 

Ready the device. No response is necessary, 
or 

Cancel all jobs by inserting X'03' in byte 4, 

and press the INTERRUPT key. 




Either; 
Insert X'02' (IGNORE) 
in byte 4, 

or 

Insert X'03' (CANCEL) 
in byte 4, and press the 
INTERRUPT key 



System operation 
continues 



Operator procedure to recover from an input/output device error, when the device 
error recovery message cannot be printed on either SYSLOG or SYSLST. 
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WAIT STATE 
MESSAGES 



2. Hardware failure 

If a hardware failure occurs that cannot be corrected by the RAS transients 
(R-transients), a message is normally printed on SYSLOG. If this is not 
possible a coded message is placed in low address storage. 



A complete list of wait state messages is given in table E-3. 



3. Unrecoverable I/O error during FETCH 

If an unrecoverable I/O error occurs during a FETCH operation, a coded message is 
placed in the low address storage bytes 0-3. 

The contents of the following 24 bytes starting at byte 4 will contain device sense 
information. 

(The number of sense bytes is device-dependent). 

The sense data is useful to your IBM customer engineer and may also be of use 

to your system programmer. The component manual for the failing device provides 

details about the cause of failure. Before repeating IPL, try a different drive. 
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A linkage editor map is an aid to program debugging. This map is obtained during 
link-editing when SYSLST is assigned (unless ACTION NOMAP was specified). 
Details about link-editing are found in DOS/VS System Control Statements. 



Other Aids 

THE LINKAGE 
EDITOR MAP 



Description 

When used in conjunction with a storage dump and program listings, the linkage 
editor map will help in locating programs and subroutines that are included in the 
programs at object time. Common areas, load address, relocation factors, low and 
high addresses are also shown. In addition, the PHASE card is displayed to show 
where the phase was loaded, which is also helpful when working with multi- 
phase programs. 

The linkage editor map also shows where programs should be located in virtual 
storage, where overlays are loaded, and whether the program is relocatable, self- 
relocating, non-relocatable or SVA-eligible. The example below shows a linkage 
editor map. 





























12/06/73 PHASE 


XFR-AD 


LOCORE 


HIC0RE 


OSK-AO 


ESD TYPE 


LABEL 


LOAOEO 


REL-FR 








• PHASE*** 


040078 


040078 


04232F 


047 13 3 


CSECT 

CSECT 

* ENTRY 

CSECT 

CSECT 

* ENTRY 

CSECT 


BEGIN 

IJFFZZHZ 
IJFFZZZZ 

IJCFZIZO 

IJDFCZZZ 
IJDFZZZZ 

IJ2L0067 


040078 

041ED8 
041ED8 

042230 

0422A0 
0422A0 

0422F8 


03C878 RELOCATABLE 
041 ED8 

042230 
0422A0 

0422F8 


. (fx 6o Kr) 






























The next two illustrations show an example of the DIAGNOSTIC OF INPUT, 
and virtual storage MAP, which are printed on SYSLST during link-editing. 

The example contains errors which are discussed in the text following each figure. 



How to use 

Refer to A-2 in this section for an example that shows how the map is used during 
debugging in conjunction with a system dump and program listing. Examples at 
the end of this chapter show the information reports that immediately follow the 
map. These reports confirm that the new phase, or phases, are correctly cataloged, 
and enable you to monitor the status of your libraries. 
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JOB 

ACTION 

LIST 

LIST 



EXAMPLE 



DISK LINKAGE EDITOR DIAGNOSTIC OF INPUT 



LIST 
LIST 



8 


LIST 


9 


LIST 


10 


21411 


11 


LIST 


12 


21311 


13 


LIST 


14 


LIST 


15 


LIST 



17 


LIST 


18 


LIST 


19 


LIST 


20 


LIST 


21 


21021 


22 


LIST 



TAKEN MAP CLEAR 

PHASE PHASE1,ROCT,NOAUTO 
INCLUDE .(NAMEONE) 



21411 EX1 0002 ESD 404040 0010 0002 POINT3 1 000244 000003 NAMETWO 2 FF0130 0000CA NAMTHREE 000200 OOO0A8 



PHASE PHASE2,x,NOAUTO 
INCLUDE ,(NAMEFOUR) 



21411 EX1 0002 ESD 404040 0010 0002 POINT3 1 000244 000003 NAMETWO 2 FF0130 0000CA NAMTHREE 000200 0000A8 

PHASE PHASE3,PHASE1+73,NOAUTO 
INCLUDE ,(NAMETWO,NAMTHREE) 

EX1 0002 ESD 404040 0010 0002 POINT3 1 000244 000007 NAMETWO 000130 001898 NAMTHREE 000200 0000A8 

INCLUDE RELMOD 

INCLUDE RELMOD 

EX1 0002 ESD 404040 0010 0002 POINT3 1 000244 000003 NAMETWO 000130 001928 NAMTHREE 000200 0000A8 

PHASE PHASE4.+ 16500 
INCLUDE RELMODUL 

21441 REL 0015 TXT 00425C 0038 F0F1 1A361A56 46D0E254 4130EF1E D500EF1E E5FA477C E2869201 EF1E0630 9509EF1D 4770E286 



AUTOLINK AUTOMOD2 

PHASE PHASE5,+X'25BA',NOAUTO 
REP 0C4018 00341 30,C03A,47F0,C30E 
REP 0C40CC 003D20E, 



PATCH ASSEMBLY ERRORS 



REP 0040CO C3F0 0003 D20EF0C5 6B404040 40404040 40404040 40404040 40404040 40404040 40404040 40404040 
ENTRY INVALID TRANSFER LABEL 



Line 1 (ACTION TAKEN). MAP and CLEAR have been specified on separate ACTION cards. Had NOAUTO been specified, it would 
also appear on this line. 



Lines 4, 7, 10, and 13. Error 2141 1 (duplicated ESID number) is printed four times because the submodular structure of the phase 
demanded four passes over the same module. As the linkage editor processes in its own input area, the record printed may not be 
identical to the original input record. Lines 10 and 1 3 differ in content from lines 4 and 7 for this reason. 



Lines 11 and 12. Line 1 1 is printed when the statement is read by the linkage editor. Line 12, error 21311 indicating that the 
requested module is not in the relocatable library, is printed after the error is detected. 



Line 16. This is an example of an error detected in a TXT statement. Error 21441 indicates that the ESID number F0F1 is invalid. (It 
should be binary 01 .) 



Line 17. Indicates the AUTOLINK feature was used for relocatable library module inclusion in the phase named above it. 



Line 19. An example of a valid REP statement. 



Lines 20 and 21. An example of an invalid REP statement. Line 20 is printed when the statement is read by the linkage editor. 
Line 21, error 21021 indicating an invalid operand in the statement, is printed after the error is detected. 



When a module is included from the relocatable library, it is not possible to guarantee that the sequence identification printed in 
columns 8-1 5 is that of the record printed. This occurs because the MAINT librarian program reblocks the content of the cards to a 
more compressed format. 



2.182 Serviceability Aids. 



Other Aids 

THE LINKAGE 
EDITOR MAP 



1 


PHASE 


XFR-AD LOCORE 


HICORE DSK-AD 


ESD TYPE 


LABEL 


LOADED 


REL-FR 




2 


COMMON 






COM 




001800 


0000C8 




3 


ROOT PHASE1 


0018C8 0018C8 


0019F7 013 2 2 


CSECT 


NAME ONE 


001 8C8 


0C18C8 


NOT RELOCATABLE 


4 








ENTRY 


POINT1 


001 8CC 






5 








x ENTRY 


POINT2 


001930 






6 


PHASE 2 


0019F8 0019F8 


001A87 013 3 1 


CSECT 


NAMEFOUR 


0019F8 


0C1750 


NOT RELOCATABLE 


7 


OVEROOT PHASE 3 


0019E8 001918 


001B1F 013 3 2 


CSECT 


NAMETWO 


001918 


001 7 E8 


NOT RELOCATABLE 


8 








CSECT 


NAMTHREE 


0019E8 


0C17E8 




9 








x ENTRY 


POINT3 


001 A2C 






10 








CSECT 


NAMEFOUR 


001 A90 


0C17E8 




11 


PHASE4 


0043A0 004140 


0059A3 013 4 1 


CSECT 


AUTOMOD1 


004140 


003A98 


NOT RELOCATABLE 


12 








ENTRY 


AUTOENT 


0042D0 






13 








CSECT 




0043A8 


0C3EF8 




14 








CSECT 


AUTOMOD2 


0043C0 


0003C0 




15 


PHASES 


002688 002688 


002767 013 6 1 


CSECT 




002688 


-001 B08 


NOT RELOCATABLE 


16 








CSECT 


NAME5 


002688 


-001 B08 




17 


"UNREFERENCED SYMBOLS 




EXTRN 


POINT2 








18 








EXTRN 


POINT4 








19 


ROOT STRUCTURE OVERLAID BY SUCCEEDING PHASE 












20 


POSSIBLE INVALID ENTRY POINT DUPLICATION IN INPUT 












21 


INVALID TRANSFER LABEL ON END OR ENTRY STATEMENT IGNORED 










22 


CONTROL SECTIONS OF ZERO LENGTH IN INPUT 












23 


002 UNRESOLVED ADDRESS CONSTANTS 














24 


003 ADDRESS CONSTANTS OUTSIDE LIMITS OF PHASE 














Line 2 (COMMON). The entry under REL-FR contains the length instead of the relocation factor in the case of ESD-type COMMON. 



Lines 5 and 9 (referring to UNREFERENCED SYMBOLS). These ENTRY labels (POINT2and POINT3) are not referenced as 
external symbols, that is, by corresponding EXTRN statements. 



Line 17 and 18. These labels indicate EXTRN references that cannot be matched with a corresponding entry point. In such a case 
*ENTRY ESD-types may be the corresponding, but misspelled, point. In the submodular structure, CSECTs not specified in any 
namelist appear as EXTRNs. The labels can also indicate unreferenced EXTRNs. 



Line 3, 6, 7, 1 1 , and 1 5. All phase origins (entries under LOCORE) are incremented by the length of COMMON. 



Line 19. Warning message. When this message appears, OVEROOT is printed to the left of the name of the phase (PHASE3) that 
overlays the ROOT phase. 



Line 20. Warning message. An entry label appeared at least twice in the input stream. At its second (or later) appearance, it was not 
possible to validate it as being a true duplication. The most common reason for this message is submodular structure with (source) 
ENTRY labels defined before the CSECT in which the entry point appears. 



Line 21. An overriding transfer label in the ENTRY statement was not defined within the first phase, or a transfer label was not 
defined in an END statement in its module. 



Line 24. Address constants had load addresses outside the limits of the phase in which they occurred. This usually occurs if the 
control section length is incorrectly defined in the input. 



Line 22. Warning message. The COBOL, FORTRAN, RPG.and PL/I (D) compilers do not supply all of the information required 
by the linkage editor in the ESD records. Specifically, the control section length is provided in the END record. If a control section 
defined in the ESD information has a length of zero, it normally indicates that the length is to appear in the END record. It is 
possible to generate zero-length control sections through assembler. Such a condition produces this message. This is not an invalid 
condition if it is not the last control section that is of zero length. If the last control section is of zero length, the length is implied 
to be in the END record and, if not present, causes an error condition. 



Line 23. These address constants correspond to the EXTRNs shown in line 1 7 and 1 8. 
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SYSTEM DIRECTORY— SYSRES 
* 12/06/73 


CORE-IMAGE 


RELOCATABLE 


SOURCE-STATEMENT 


PROCEDURE 












DECIMAL 














* OIRECTORY STARTING ADDRESS 

DIRECTORY NEXT ENTRY 
fc DIRECTORY LAST ENTRY 


C H R E 
00 10 01 
00 11 IS 15 
00 14 15 17 


C H R E 
16 00 01 
16 01 07 02 
16 04 17 19 


C H R E 
31 00 01 
31 00 08 03 
31 04 27 09 


C H R E 
41 00 01 
41 00 03 04 
41 04 27 09 










LIBRARY STARTING ADDRESS 
t LIBRARY NEXT AVAILABLE ENTRY 
* LIBRARY LAST AVAILABLE ENTRY 


00 15 01 
13 13 02 
IS 19 04 


16 05 01 
27 04 05 
30 19 16 


31 05 01 
38 14 05 
40 19 27 


41 05 01 
41 09 22 
45 19 40 














STATUS I NFORMAT ION— 














DIRECTORY ENTRIES ACTIVE 


537 


457 


68 


19 










* LIBRARY BLOCKS ALLOCATED 

LIBRARY BLOCKS ACTIVE 
k LIBRARY BLOCKS OELETED 
' LIBRARY BLOCKS AVAILABLE 


1220 

1033 

00 

187 


4720 

3508 

00 

1212 


5265 

4027 

00 

1238 


3795 

176 

00 

3619 










k AUTOMATIC CONDENSE LIMIT 


00 


00 


00 


00 








<3< 


LIBRARY ALLOCATED CYLINDERS 
fc DIRECTORY ALLOCATED TRACKS 


15 
05 


15 

05 


10 
05 


05 
05 


text,*?) 























An example of the SYSTEM DIRECTORY status information printout that 
immediately follows the MAP, after cataloging a phase to the system core image 
library on SYSRES. 



















PRIVATE DIRECTORY 


PRV-CORE IMAGE 


PRV-RELOCATABLE 


PRV-SOURCE STATEMENT 








™ ! 12/06/73 

• OIRECTORY STARTING AODRESS 
; DIRECTORY NEXT ENTRY 
3 a OIRECTORY LAST ENTRY 


C H R E 
47 10 01 
47 12 06 07 
47 14 15 17 


"■"-■ — — •— ~0E C I MAL" 

C H R E 
73 00 01 
73 02 09 13 
73 09 17 19 


C H R E 
103 00 01 
103 01 IS 07 
103 09 27 09 








LIBRARY STARTING AODRESS 
A LIBRARY NEXT AVAILABLE ENTRY 
v LIBRARY LAST AVAILABLE ENTRY 


47 IS 01 

71 09 01 

72 19 04 


73 10 01 

98 04 06 

102 19 16 


103 10 01 
196 05 02 
196 19 27 








OIRECTORY ENTRIES ACTIVE 


631 


——STATUS INFORMATION 
848 


412 








• LIBRARY BLOCKS ALLOCATED 
LIBRARY BLOCKS ACTIVE 

_ LIBRARY BLOCKS OELETED 

* LIBRARY BLOCKS AVAILABLE 


2020 

1812 

84 

124 


9440 

7909 

00 

1531 


50490 

50086 

00 

404 








ft AUTOMATIC CONDENSE LIMIT 


00 


00 


00 








, LIBRARY ALLOCATEO CYLINDERS 
a DIRECTORY ALLOCATED TRACKS 


26 

05 


30 
10 


94 
10 


(exdXti) 



















An example of the PRIVATE DIRECTORY status information printout that 
immediately follows the MAP after cataloging a phase to the private core image 
library. SYSTEM DIRECTORY status information, shown above is printed 
following this report. 

Note: The format of this printout depends on whether SYSCLB, SYSRLB, and 
SYSSLB were assigned before the linkage editor run. 
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Summary THE LINKAGE 

EDITOR MAP 

The following list summarises the information contained in the map. 

1. The name of each phase, the lowest and highest virtual storage locations of 
each phase, and an indication if the phase is relocatable, non-relocatable, 
self-relocating or SVA-eligible. It also shows the disk address in hex where the 
phase begins in the core image library. 

2. An indication if the phase is a ROOT phase, or if a phase overlays the ROOT 
phase in any way (designated by OVERROOT). 

3. The length of COMMON, if appropriate. 

4. The names of all CSECTs belonging to a phase, the address where each CSECT 
is loaded, and the relocation factor of each CSECT. 

5. All defined entry points within a CSECT. If an entry point is unreferenced, it 
is flagged with an asterisk (*). 

6. The names of all external references that are unresolved. 

7. The transfer (execute) address of each phase. 

8. Warning messages are printed if: 

• The ROOT phase has been overlaid. 

• A possible invalid entry point duplication occurred. 

• The ENTRY or END statement contained an invalid (undefined) 
transfer label. 

• At least one control section had a length of zero. 

• The assembled origin on an RLD statement was outside the limits of 
the phase. 

• An address constant could not be resolved. 

These messages may or may not indicate actual programming errors. If NOMAP 
is operational, the warning messages are not printed. 
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Hardware Error Recording and Recovery 



RMS 



General Description of RMS 

The need for the IBM serviceability aids that are collectively termed RMS (Recovery 
Management Support) has been described in Section 1 under the heading 
"Hardware Failures." 

RMS consists of software routines that are grouped according to their function: 

• MCAR (Machine Check Analysis and Recovery) 

• CCH (Channel Check Handler) 

• ERP (I/O device Error Recovery Procedures) 

• RMSR (Recovery Management Support Recorder). 

Each function listed above is considered to be a function of RMS, and if required, 
must be included in your supervisor during system generation. The function RMSR 
consists of several recording facilities: 

Unit check recording 

Machine check and channel check recording 

Tape/disk error statistics by volume 

MDR (Miscellaneous Data Recorder) 

IPL information 1 Reliability Data 

End of Day recording for devices and for the system. J Extractor (RDE) 

RMS is always supported on the Models 135, 145, 155-11 and 158, and the RMSR 
facilities supported depends on the parameters specified during system generation. 
The parameters of the supervisor macros affecting the subjects described in this 
section are discussed here but further details required for generating a supervisor 
are found in the DOS/ VS System Generation manual. 

System Requirements 

In order to perform its functions, RMS uses two logout areas contained in real 

storage: 

• The fixed logout area 

• The model-dependent log out area (not applicable to Models 1 15 and 125). 
As the name "model-dependent logout area" implies, the real storage area reserved 
for the logout areas varies for different System/370 Model types. Therefore, if 
you know during supervisor generation that the supervisor will be used on a larger 
model, specify the larger model in the MODEL = parameter of the CONFG super- 
visor generation macro. 

Because the Models 115 and 125 employ both software and hardware recording 
functions a more detailed description on these Models is given in the following 
paragraphs. For the Model 125, a hardware function records CPU and channel hard- 
ware failures on the DISKETTE. This also applies to hardware failures of natively 
attached I/O devices. Device ERP is always supported for all models. When the 
Models 115 and 125 support channel attached I/O devices, or magnetic tape units, 
or teleprocessing, RMSR support must be generated during system generation. 
(RMSR support records until checks on SYSREC.) RMSR support can be generated 
by either the parameter CHAN=YES, or RMS=YES, in the SUPVR system 
generation macros. 

When RMS=YES: hardware failures that occur on all attached I/O devices are 
recorded on SYSREC by the RMSR software routines. However no error recording 
occurs for the Multifunction Card Machine (MFCM) if attached. Simultaneously the 
failures that occur on natively attached devices are also recorded on the DISKETTE 
by a hardware function. In the latter case of RMS=YES, MCAR/CCH records are 
recorded on SYSREC as well as on the DISKETTE, and the RDE facility is also 
supported. 

When RMS=NO and CHAN=YES: the supervisor generated supports RMSR for 
channel attached devices, tape units, TP and MCH/CCH. Therefore hardware 
failures that occur on these devices are recorded on SYSREC by the software 
routines as well as being recorded on DISKETTE by the hardware recording 
function. In this case however RDE is not supported. 

When RMS=NO, CHAN=NO and MCH=NO: no recording occurs on SYSREC and 
a hard wait is entered on the occurrence of a hardware failure 
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Legend 



■*- Data flow 

•*- Manual control 



Operator communications 



Notes: 

1. Not applicable to Models 1 15 and 125. 

2. Not applicable to Models 115 and 125. 
that does not support the RMSR 
function. 

3. Use the U hardware command 
for a Model 1 15 and 125 that 

does not support the RMSR function. 



Hardware Error Recording and Recovery 

RMS 

Hardware errors 



CPU errors 



Hardware instruction retry 
(HIR). Error checking and 
correction (ECC) 



Channel, control unit or 
device errors 



Use the MODE command to: 

• Set HIR or ECC to recording or 
quiet mode. (See note 1 ) 

• Change the error frequency limit, 
(EFL) threshold values for HIR 
and ECC. (See note 1) 

• Inquire about the status of 
present recording mode. (See 
note 1) 

Set the recording mode for tape 
error statistics (TES) recording. 
(See note 2) 

• Change type of recording for 
a specific device. (See note 2) 





Machine check 
and 

input/output 
interrupts 



Hardware control 



Software control 



Messages printed on SYS LOG or 
displayed on DOC inform operator 
of a hardware failure. 



DISKETTE 




Error 
Data 



Recovery Management Support (RMS) 

• Check severity of the error 

• Attempt recovery from the error 

• Record the error on SYSREC 

• Print informative messages on SYSLOG. 



Issue ROD command at 
system switch-off, or at end of 
shift, or end of day. (See note 3). 
IPL reason information 
(See note 2) 



Messages on SYSLOG inform 
operator about status of 
SYSREC, (Full, overflow, etc.) 



System 
recorder 

file. 
SYSREC 



EXEC EREP. Initiated by job 
control statement. 



Select System/370 EREP options 
by control statements. 



f 
i- 



No recording on SYSREC 
occurs on Models 1 15 and 
125 when RMS = NO 



System /370 EREP 



-*- System/370 EREP options. 
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RMS Operation 



An understanding of the purpose and operation of RMS will help when 
interpreting the EREP printout and the System/370 Models 115 and 125 
Maintenance Log Analysis Feature. 

The following four figures show the relationship between the hardware and 
software recording facilities, and show the connection between the DISKETTE 
(Models 1 15 and 125 only), the SYSREC file, and the EREP options. 

Figure F-l-A shows the types of machine checks generated and the real storage 
used for the logout areas. Error information is first logged in this area before being 
used by the RMS software routines. On the System/370 Models 1 15 and 125, 
the logout area is replaced by the DISKETTE recording file. 

Figure F-l-B describes the division of machine check interrupts into soft machine 
checks and Figure F-l-C illustrates the general flow of processing after a hard 
machine check occurs. 

Figure F-l-D expands the RMS routines into: 

• MCAR 

• CCH 

• Channel check ERPs that are initiated by CCH routines for device-dependent, 
channel error recovery. 

• Unit check ERPs that handle the unit check conditions of the devices. 

This figure also shows how the errors are first checked for their severity, and shows 
how the effect on system operation depends on the type and severity of the error. 

Figure F-l-E shows the types of records that are recorded on SYSREC. 

Figure F-l-F represents the EREP options that can be selected by the operator. 
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CPU 
retry 
failures 



Hardware Error Recording and Recovery 

RMS 



Main storage or control storage 
(ECC) failures 



HIR 



Storage 

error 

corrected 



Input/output 
channel or 
control unit 
device failures 



Storage 

error 

uncorrected 



CD 
Ti nrie of 
day clock 
damage 



TD 
Timer 
damage 



Key in 
storage 
uncorrected 



PD 
Instruction 
processing 
damage 



SR 
System 
recovery 



ED 

External 
damage 



SD 
System 
damage 




Machine check interrupts 





I/O interrupts 



Hard machine check interrupts 



Soft machine check interrupts 



For the Models 115, 125 
and 1 58 log out areas 
are replaced by the 
DISKETTE 



PSWs, CSW, CAW 
timer 



I/O communications 
area 



Fixed logout 
area 



CPU extended 
logout area 



Extended channel 
logout area 



Figure F-1-A illustrates how data about a hardware error is logged in 
fixed areas of real storage, or on the DISKETTE. 
This data is used by soft ware routines for error recovery (where 
possible), and for recording the data on SYSREC. 



Serviceability Aids. 2.191 



Hardware Error Recording and Recovery 

RMS 



Soft Machine Check Interrupts 



Successful 

CPU retry 

HIR 

(Not applicable to 

Models 115 and 125) 



ECC single-bit inter- 
mittent processor 
storage correction 
(if enabled by 
operator) 



For a Model 1 15 or 125 that does not 
support the software MCAR/CCH, a 
coded message is placed in general 
register 11(X'B') and low address 
storage and system operation is 
terminated. 



I 



External Damage 
(Not applicable to 
Models 1 15 and 125) 




Log status and 
record report 
on SYSREC 



I 



Inform operator 
of action; 
continue processing 



Time of Day 
Clock damage 



Only applicable 
to the Models 
115 and 125 
if RMS=YES 



Figure F-l-B. General flow of DOS/VS MCAR processing after soft machine check interrupts 

Hard Machine Check Interrupts 





I 




1 






I 




I 










Uncorrectable 
or unretryable 
CPU error 
associated 
with control 
program 




Multiple-bit 
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Figure F-l-C. General flow of DOS/VS MCAR processing after hard machine check interrupts 
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Figure F-1-D Illustrates the connection between hardware error detection 
and software routines that enable data about the error to be recorded. It 
also shows the system action taken, depending on the type of error. 
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Figure F-l-E Input records to SYSREC. 
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Figure F-l-F Output from SYSREC. 

(Selected by EREP options.) 
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Components 

The software routines required to support the RMS options are: 
Resident MCH 
Resident CCH 
Resident RAS monitor 
Resident DASD ERP 
Device ERP transients (A transients) 
MCH/CCH transients (R transients) 
RMSR transients (A and R transients). 

To record tape and disk error statistics by volume, the option RMSR also uses 
some B transients. A job control module is required to enable RMSR to record 
IPL/EOD data. 

The figures below shows the relative locations, in the real address area, of the 
RTA (RAS transient area), LTA (Logical transient area), and PTA (Physical 
transient area). 

Note: No error recording or recovery can be executed before IPL is successful. 



Hardware Error Recording and Recovery 
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RMS 



Note: Not applicable to the 
Models 115 and 125 



Note: There is no need for 
software control or EFL for 4 
HIR on the Models 115 
and 125 



Detailed Description of RMS Functions 

Machine Check Analysis and Recovery (MCAR) 

Two hardware error recovery features, Hardware Instruction Retry (HIR) and 
Error Checking and Correction (ECC), perform hardware correction for machine 
malfunctions. RMSR interfaces with the error correction hardware through 
Machine Check Analysis and Recovery (MCAR). 

When the CPU is in the 'recording mode,' MCAR is informed when a machine 
malfunction occurs and is corrected by means of a 'soft' (or recovered) Machine 
Check Interrupt (MCI). When the CPU is in 'quiet mode' the hardware correction 
routines do not generate a soft MCI if the malfunction is corrected. If the hardware 

: correction routines cannot correct the malfunction, a 'hard' (or unrecoverable) 

\ MCI is generated regardless of the mode setting. 

I When a soft MCI occurs, RMSR writes a record in the recorder file containing 
I identification information and the contents of the machine-independent logout 
\ area and the machine-dependent logout area (if available). The operator is 

notified that a soft MCI occurred, control is returned to the interrupted code, and 

system operation continues. 

Dynamic Reallocation of Partition or page pool (DRAP): When a hard MCI occurs, 
the MCAR routine attempts to isolate the failure to a partition in order to cancel 
the damaged task and, if possible, continue. system operation. If the system cannot 
continue because the failure occurred in an area critical to system operation, 
recording is attempted, after which the system enters a hard wait state. 

When a hard MCI is caused by an unrepairable real storage position, MCAR 
dynamically reallocates storage. Informative messages are printed on SYSLOG 
that alert the operator of any action taken by DRAP. 

MCAR Modes of Operation: An error Frequency Limit (EFL) algorithm prevents 
SYSREC from filling up too quickly if a large number of intermittent failures 
occur. The initial IBM -supplied EFL and either eight (Models 155-1 1 and 158) or 
sixteen (Model 145; eight for control storage and eight for processor storage) soft 
; ECC MCIs within an eight-hour period. These values are set at system generation 
j time and can be changed by the MODE command. A message is issued on the first 
occurrence of a soft MCI on a System/370 Model 135 and all recoverable machine 
checks are disabled. The MODE command must be issued to re-enable reporting of 
soft machine checks. These values are set at system generation time but can be 
changed by the MODE command. 

MCAR supports EFL for two hardware facilities: 

• Hardware Instruction Retry 

• Error Checking and Correction. 

EFL Threshold Values: At IPL time, the EFL threshold values are established so 
that the EFL algorithm controls the number of soft MCIs recorded. These 
values are : 

• The number of soft MCIs 

• A specific time period. 

When these EFL values are reached, a change in moderof operation occurs. Until 
the EFL threshold values are reached, the system operates in recording mode. 
This is the normal mode of operation in which an MCI occurs for all machine 
check conditions. After the EFL threshold values are reached, ECC (or ECC and 
HIR) is placed in quiet mode. In quiet mode, no MCIs occur for recovered errors; 
therefore, the number of corrected errors is unknown. 

EFL threshold values are not applicable to the Models 1 15 and 125 owing to the 
recording of erros by a hardware function. 
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Hardware Instruction Retry (HIR) Modes: The two HIR modes are: RMS 

• Recording. A soft MCI occurs for every hardware instruction correction. 

• Quiet. No soft MCI occurs for hardware instruction correction. (Recording 
is always quiet for the Model 125.) 

Error Checking and Correction (ECC) Modes: The ECC modes are: 

• Recording. A soft MCI occurs for every main or control storage correction. 

• Quiet. No soft MCI occurs for real or control storage correction. (Recording 
is always quiet for the Model 125.) 

• Threshold (Model 145 only). A soft MCI occurs after a predetermined 
number of unrecorded control storage errors have occurred within a given 
time period. Threshold mode is a hardware function and is not affected by 
EFL threshold values. 

If HIR is in quiet mode, ECC is also in quiet mode. When ECC is in quiet mode, 
HIR can still be in recording mode. 

At IPL time the system assumes the IBM-supplied EFL threshold values; these 
values can be changed by the MODE command. When IPL is completed: 

• For the Model 145, recording mode is entered for HIR, quiet mode is 
entered for main storage ECC, and threshold mode is entered for control 
storage ECC. 

• For the Models 155-1 1 and 158, full recording mode is entered for both 
HIR and ECC 

Channel Check Handler (CCH) 

When a channel check occurs, channel error information is logged and an interrupt 
is generated. The CCH resident program investigates the severity of the malfunction. 
If the severity is such that system operation need not be immediately terminated, 
the CCH resident program: 

• Builds the Error Recovery Program Interface Bytes (ERPIB) containing 
error information for use by the appropriate CCH/ERP 

• Records the error information on the recorder file 

• Attempts to isolate the error to a device. 

If the error cannot be isolated to a device, CCH cancels all problem programs that 
use the malfunctioning channel. If the error can be isolated to a device and the 
device is supported by a CCH/ERP, the appropriate CCH/ERP is loaded into the 
R-transient Area (RTA). Then ERP examines the ERPIB supplied by CCH and 
determines the severity of the error. Whenever possible, the failing channel 
command is retried. If the command cannot be retried, or if retry fails, a message 
is written on SYSLOG, and all problem programs using the failing device are 
cancelled. If recovery is successful, a message is also written on SYSLOG, unless 
SYSLOG was the failing device. Certain retry conditions require manual operator 
intervention to enable proper retry. 

Note: If the 'accept unrecoverable error' bit in the CCB is on, the error is posted 
and control is returned to the problem program. 

If no CCH/ERP is available for an error isolated to a device, all problem programs 
using that device are cancelled. 
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R MS Error Recovery Procedures (ERP) for I/O Devices: 



Each I/O device or class of I/O devices has a unique device error recovery routine. 
The appropriate routine is entered from the channel scheduler upon detection of 
an error. The function of the error recovery procedures (ERP) is to attempt 
recovery from the error either through programmed recovery or by operator 
intervention. If recovery is not possible, the following choices are available, where 
applicable: 

1. The error can be ignored. 

2. The task can be terminated. 

3. The problem program can take action (exit to a user routine). 

4. The record in error can be bypassed. 

Depending on the type of error, the type of device, and whether Logical IOCS 
is used, some or all of these options are available. Choices 3 and 4 are available 
through LIOCS only. In the absence of any other options, only choice 2 is 
available. 

At the time the error is first detected, before ERP is called to attempt recovery, 
RMSR accumulates certain information relating to the status of the device in the 
PUB2 for the device. The device ERP then gets control and tries to correct the 
error. If the ERP cannot recover, RMSR builds and writes the unit check record, 
containing the statistical data from the PUB2 and the status and sense information 
at the time the ERP determined the error was unrecoverable. If the ERP recovers, 
the statistical data in the PUB2 is not cleared. This information is recorded at the 
next permanent error for that device, at the next statistical counter overflow for 
that device, or at end-of-day when the operator issues the ROD command. 

Besides the unit check record (written for every permanent error) and the counter 
overflow record (written when a statistical counter becomes full or when the 
operator issues the ROD command), RMSR also writes Tape Volume Dismounts 
records. The data recorded in the Tape Volume Dismount records corresponds 
to the data formerly accumulated in the TEBV table; the EREP TES (Tape Error 
Statistics) options are used to format and summarize this data. 
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SYSREC (System Recorder File) 

The recorder file must be created and assigned to a disk device that is always on 
line. It is assigned after IPL, before the first job. 

The recorder file is not CPU or SYSREC dependent. Thus it can contain records 
from more than one DOS/VS system. 

Once the file is created, no further operator intervention is required, unless the 
recorder file is damaged or the operator action listed in the DOS/VS Messages 
manual specifically requests the file to be re-created. For example, message 

0T03I ERROR ON RECORDER FILE. 

On subsequent IPLs the system opens the recorder file and continues to update it. 

Note: Recording on the recorder file is suppressed during execution of the 
EREP program. 

Creating the Recorder File: The method of creating SYSREC and the job stream 
needed depends on whether the file is to be part of the system residence unit 
SYSREC, or whether it is to reside on a separate disk volume. 

For details and job stream examples, refer to the DOS/VS System Management 
Guide. 

SYSREC Record Types: SYSREC contains variable-length records with a maximum 
size of 200 bytes (including a standard 24-byte header). The types of recording 
that RMSR performs are: 

• MCAR recordings 

• CCH recordings 

• Unit check recordings 

• Counter overflow recordings 

• Tape volume statistics recordings 

• IPL/EOD recordings 

• Miscellaneous Data Recorder (MDR) recordings 

• Teleprocessing error records (TPER). 

MCAR: Formats an environment record (recovery report) after a soft machine 
check. 

The record is written on the environment recorder data set (ERDS), which has 
the symbolic name SYSREC. The record contains the following pertinent 
information about the error: 

• Status information from the fixed logout area in real storage 

• Recovery action 

• Program identification 

• Date 

• Time of day. 

CCH: Formats an error information block for use by the ERP routines after an I/O 
interrupt, caused by a channel check. 

The record is written on SYSREC, and contains the following information: 

• Status information from the logout area 

• The ECSW (extended channel status word) 

• Date 

• Time of day. 

MCAR also records data on SYSREC about hard machine checks. 



RMS 



Note: Not applicable to the 
Models 115 and 125 using 
a supervisor that does not 
support the RMSR function. 
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R MS UNIT CHECK RECORD: Device ERPs attempt recovery from an error, usually 

by retrying the failing channel command. If the error is not corrected after a 
certain number of retries, RMSR writes a unit check record which contains 
hardware information (sense data), statistical data, and identification data. All 
information relevant to the status of the device at the time the failure is recognized 
as permanent is contained in this record. One unit check record is written for each 
permanent error. RMSR resets the statistical counters in the PUB2 table at the 
same time. 

COUNTER OVERFLOW RECORD: Whenever a statistical counter in the PUB2 
table fills up, a counter overflow record is written on SYSREC. The counter 
overflow record is also written for each device that has unrecorded statistics when 
the operator issues the ROD command. The statistical counters in the PUB2 table 
for the device are cleared at the same time. 

IPL/EOD: I/O error logging for System/370 users includes RDE (Reliability Data 
Extractor). If ERRLOG=RDE is specified during system generation, RDE gathers 
hardware reliability data that IBM personnel use to evaluate hardware performance. 
Two types of records are written on SYSREC by RDE: 

• An IPL record. This specifies the reason for IPL. 

• An EOD (End-of-Day) record. This is initiated by the ROD command, which 
should be issued before the system is shut down. 

EREP uses these records to identify RDE data. 

For the System/370 Models 1 15 and 125 the operator must save the disk usage 
counters at the end of the day (or end of shift or prior to system switch-off) by 
using the U command of the mode select display. 

MISCELLANEOUS DATA RECORDER (MDR): RMSR makes recordings on the 
SYSREC file for the 321 1 printer buffer errors and the 3330 and 3340 Disk 
Storage errors. 

TAPE VOLUME DISMOUNT RECORD: When processing standard labelled tapes 
using LIOCS, RMSR makes a recording on SYSREC each time a new volume serial 
number is detected. When the tape is opened, the number of the current tape is 
compared with the serial number in the PUB2 for that tape drive. If the serial 
numbers are different, a volume dismount record, containing volume usage and 
Tape ERP recovery statistics, is written on SYSREC. The statistical counters in the 
PUB2 relating to usage and error recovery action are cleared and the serial number 
is updated. Processing continues and statistical data for the new tape is accumulated 
in the PUB2 table. 
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TES (Tape Error Statistics) RMS 

A major factor affecting the quality of an operating system is the condition of the 
volume stored on a magnetic medium, such as tape. Such a medium is subject to 
contamination from dust, foreign materials, fingerprints, and particles of oxide 
coating. 

Because of these environmental factors, it is desirable to record the number of 
read and write errors occurring on each tape volume. By monitoring the error 
rate, a report can be kept on the condition of each tape volume in a tape library. 

System Requirements: For Tape Cartridge Readers. When error statistics are 
required to monitor tape cartridges used on the 2495 Tape Cartridge Reader 
specify TEB = n in the FOPT macro, (n specifies the number of tape cartridge 
readers attached to the system.) 

For magnetic tape volumes when error statistics are required to monitor tape 
volumes, specify TEVB=IR or CR in the FOPT macro. 

For all standard labeled tapes, tape statistics are accumulated by volume. For 
unlabeled and nonstandard labeled tapes two types of error recording are 
available: 

• Combined Recording (CR) 

• Individual Recording (IR). 

When TEBV=CR is specified, the error statistics for all unlabeled and nonstandard 
labeled tapes on a specific tape unit are accumulated until a labeled tape is 
mounted and opened on that unit. Then, one recording for the unlabeled and 
nonstandard labeled tapes is made, and the counters are reset in the PUB2 table. 

Specify TEBV=IR to record tape error statistics on the SYSREC file and to reset 
the PUB2 table counters at each OPEN for unlabeled and nonstandard labeled 
tapes. 

The mode of recording for nonstandard labeled and unlabeled tapes can be 
changed with the tape options of the operator's MODE command. 
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Not applicable to the 
Models 115 and 125 
using a supervisor 
that does not support 
the RMSR function 



EVA (Error Volume Analysis) 

This option of RMSR enables you to specify the number of temporary read/write 
errors that can occur on a tape volume before an informatory message is printed 
on SYS LOG. 

System Requirements: The number of temporary read/write errors needed to 
print the informatory message must be specified by EVA=r and/or w the FOPT 
macro during system generation, (r specifies the threshold level of temporary read 
errors, and w specifies the threshold level of temporary write errors.) 

Description and operation: The message that EVA issues to SYSLOG contains the 
number of temporary read errors, temporary write errors, and START I/Os, the 
physical unit identification, and if standard labeled tape is used, the volume serial 
number. 

The message format is: 

4E10I xxxxxx cuu TR-nnn TW-nnn SlO-nnnnn 

where: 

xxxxxx Serial number of standard label volume (blank 

when nonstandard or unlabeled volume is 

being used) 
cuu Channel/unit address (physical unit) 
TR-nnn Number of temporary read errors 
TW-nnn Number of temporary write errors 
SlO-nnnn Number of START l/Os. 

Either the TR=nnn or the TW=nnn field contains one or more than the 
predetermined error threshold specified in the FOPT macro. When the threshold 
is reached, a notification, for example, 0P1 1 , is sent to the system operator. There 
is no interruption in the execution of the problem program. 

How and when to use: When using an unlabeled or nonstandard labeled tape, a 
note can be made of the volume identification of the volume in use when the 
message is received in order to monitor it. 

By monitoring your magnetic tape volumes, a record can be accumulated of 
read/write errors per volume. 

Operational delays caused by old or worn tapes can be avoided by cleaning and 
erasing the volume, or by cutting off the first ten yards of the volume that indicates 
read/write errors. 

Note: The first part of a tape volume contains label information and is the part of 
the tape that suffers more from mechanical friction. Therefore, the oxide coating 
is more likely to cause read /write errors on the first part of a tape than on any 
other part. 
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Operator commands for controlling RMS 

The error recording facility is under the control of the operator. In addition to 
creating the recorder file (SET RF=CREATE) and responding to error messages, 
the operator has the following responsibilities: 

• Matching PUB2 space to devices attached 

• Issuing the ROD command in response to the problem determination action 
of an error message, or prior to turning the system off or performing a 
re-PIL 

• Providing IPL reason information (RDE users only) 

• Issuing the MODE command to set the type of recording accomplished by 
the MCAR/CCH, CE, and tape error statistics portions of RMSR 

• Executing the EREP program and directing EREP to perform the correct 
function. 

The following sections describe these items more fully. 



Matching PUB2 space to devices attached to the system 

During IPL, the following message may be issued: 

01291 INSUFFICIENT PUB2 SPACE AVAILABLE, RE-IPL 

IPL is automatically canceled, and during the re-IPL the operator must delete 
devices until the above message is no longer issued. 

The reason for this message may be a change in system configuration since 
supervisor generation, or it may be that the supervisor in use has not been 
generated for the same amount and type of disk and tape devices. PUB2 (a table 
in the supervisor) contains a counter for statistical data on device operation and 
is used by the RMSR routines. 

Parameters of the IOTAB supervisor generation macro increase the size of PUB2 
to accommodate the counters for devices attached to your system that require a 
larger field than the standard 12-byte PUB2 field. 

The PUB2 table is described in more detail in the DOS/VS Supervisor manual. 

IPL/EOD (End-of-Day) recording 

This RMSR facility enables data to be recorded on the system recorder file 
(SYSREC) about the reason for, and time between, operator IPLs. 

This allows IBM and installa'tion management to monitor IPLs for any selected 
time period, for example, during an 8 hour operator shift. 

When RDE is required, specify ERRLOG=RDE in the SUPVR macro during 
system generation. 

The ROD command (Record on Demand) 

Using this command will ensure that any statistical data held in the PUB2 table 
is added to the recorder file. For System/370 RDE users, the ROD command also 
writes the EOD (End-of-Day) record on SYSREC. The command ROD has no 
operand. BTAM and QTAM use their own separate methods of updating all disk 
counters during closedown or cancel. 

For the System/370 Models 115 and 125, the operator must save the disk usage 
counters at the end of the day (or end of shift or before system switch-off) by 
using the U command of the mode select display. 
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Note: Not applicable to the 
Models 115 and 125 using 
a supervisor that does not 
support the RMSR function. 
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Note: Not applicable to the 
Models 115 and 125 using 
a supervisor that does not 
support the RMSR function. 



When to use: 

1. Operator actions listed under appropriate messages in DOS /VS Messages 
indicate when to issue this command. 

2. In order to create meaningful END-OF-DAY records on the system recorder 
file, you must respond with y to the message END-OF-DAY= at system 
shutdown or at the end of every shift. 

(If the END-OF-DAY record is not required, respond with n to the END-OF-DAY= 
message.) 

IPL reason information 

During the processing of the first // JOB statement after IPL, RDE users must 
provide additional information about the system. Message 1I90D IPL REASON 
CODE= is issued on SYS LOG. You must respond to message 1I90D with a Reason 
Code followed by End. 

If a Reason Code is not entered (only the END key is pressed) or if SYS LOG is 
down or not assigned to a 3210, a 3215 or a Model 125 video display unit, then 
the default, DF, is assumed. However, if an invalid code is entered, message 1I89I 
is issued and message 1I90D is reissued until a valid response is made. 

After the Reason Code is entered, message 119 ID SUB-SYSTEM ID= is issued. 
You must respond to message 119 ID with one of the ID codes followed by END. 
The ID codes further identify the reason for performing IPL. The ID codes and 
the reasons are shown in the table below. x 



IPL REASON CODE 

CE 



DF 
EN 



IE 



IM 



ME 



NM 
OP 



UN 
UP 



IBM CE/SE has control of the system 

and is not doing user work. 

Default. 

Environmental problem (such as: power, 

overheating, etc.) caused failure. 

IBM hardware or a IBM-supplied-program 

error that did not require an IBM CE/SE. 

IBM hardware of IBM-supplied-program 

error that required an IBM CE/SE. 

Media. Hardware error caused by a faulty 

disk pack, reel of tape, cards, etc. 

Normal IPL. 

Operational problem. Operator error 

or procedural problem. 

Unknown. Undetermined error. 

A user (non-IBM-supplied) program caused 
the failure. 



SUB-SYSTEM ID 

00 Unknown. Must be used with Reason Codes DF, EN, NM, OP, UN and UP. 

00 is the default. 
10 Processor. CPU, channel (integrated), storage unit, etc. failure. 
20 DASD. A failure occurred in a DASD unit or its associated control unit 

(2311, 2314, 2319, 2841 , 3330/3333, etc.) 
30 Other. A device without an ID code (such as a paper tape unit) caused the 

failure. 

40 Magnetic Tape. A failure occurred in a magnetic tape unit or its associated 
control unit (2400, 3400, etc.) 

50 A failure occurred in a card reader /punch, a printer or in its associated 

control unit (2540, 3525, 1403, 2821 , etc.) 
60 MICR/OCR. A magnetic ink character reader (1412, 1419, etc.) or an optical 

character reader (1 285, 1287, 1288, etc.) failure. 
70 A teleprocessing failure occurred in a teleprocessing control unit 

(2701,2702, 3705, etc.) 
80 Graphic. A video display unit (2260, etc.) or its associated control unit 

failure. 

90 An IBM-supplied SCP Type 1 or Type 2 program (such as the DOS/VS 
system or one of its components) failure. 

91 An IBM Programming Product failure. 



Table F-2-A IPL reason codes 



If the ID code is not entered (only the END/ENTER key is pressed) or if SYSLOG 
is down or not assigned to a 3210, a 3215 or a Model 125 video display unit then 
the default, 00, is assumed. However, if an invalid ID code is specified, message 
1I89I is issued and message 119 ID is repeated until a valid response is made. 

Notes: 

1. Always use ID code 00 with Reason Codes DF, EN, NM, OP, UN, and UP. 

2. ID codes 10, 20, 30, 40, 50, 60, 70, 80, 90, and 91 should be used with Reason 
Codes CE, IE, IM, and ME. 

Normal processing continues after the IPL information has been specified. In order 
to create meaningful data on average running time per IPL, you must issue the 
ROD command beforfe the system is shut down at the end of the working day, or 
at the end of a shift. By this procedure, an accurate record can be maintained on 
the system recorder file, which is printed periodically using an EREP option 
explained later in this section. 



2.204 Serviceability Aids. 



Hardware Error Recording and Recovery 



The MODE command 



RMS 



This command should be used only at the request of your IBM customer engineer. 



,l[,xx,y] 
,D[,xx,y] 
,N 
MODE 



Not applicable 
to the Model 125 




* 



[,E=eeee] [,T=tttt] 



*Note: When either HIR or ECCis specified, at least one of the optional operands 
within these braces must be selected. THis only valid for the Model 145 when 
ECQCis specified with the MODE command. 

The mode command provides the following options for controlling RMSR: 
Reset the recording mode for unlabeled and nonstandard tapes. 
Set recording mode for a particular device to intensive, diagnostic, or no 
mode. 

Initiate or suppress HIR (Hardware Instruction Retry) and ECC (Error 
Correction Code) error recording. 

Request the Mode that the system is operating in (the status of the system). 
Change the mode of operation from Q (quiet) to R (recording) or from 
R to Q. 

Specify EFL threshold value to override the IBM-supplied value. 
Place the Model 145 Control Storage ECC in threshold mode. 

The MODE command is a notational command. Operands of the MODE command 
can be entered in any order and must be continuous with no blanks between or 
within operands). The STATUS operand cannot have any other operands before 
or after it. 

The total length of the MODE command must not exceed 30 characters. 

The table below describes the parameters for the MODE command: 




Note: Not applicable to the 
Models 115 and 125 using a 
supervisor that does not support 
the RMSR function. 



Nop: Not applicable to the 
Models 115 and 125. 



Operand 


Description 


IR 
CR 


Recording mode for nonstandard labeled and u'nlabeled tape. Specify Individual Recording (IR) if you wish to record 
and then reset the tape error statistics at each tape OPEN. Specify Combined Recording (CR) to accumulate all the 
statistics from nonstandard labeled and unlabeled tape on a specific tape unit until a standard labeled tape is opened. 
Then one recording of the statistics from all the nonstandard labeled and unlabeled tapes is made on SYSREC, and 
the statistical counters are reset in the PUB2 table. 


CE 


The recording mode for a device at physical location X'cuu' may be reset. The possible recording modes are: 

b Normal. The default, normal, is assumed. 

1 Intensive. Normal recording continues. In addition, the next seven errors of a particular type (xx,y) or the next 

seven errors of any type (if xx,y is not specified) are recorded. The number of I/O retries required for success is 

also recorded. 
D Diagnostic. Normal recording continues. In addition, the next seven errors of a particular type (xx,y) or the 

next seven errors of any type (if xx,y is not specified) are recorded. The number of I/O retries required for 

success is also recorded. 
N No recording. 

When the recording mode parameter is the last parameter of the MODE command, a check is made to see if all errors 
are recorded. When in intensive or diagnostic mode, it is possible to check for only one type of error. Indicate the 
bit to be examined with: 
(xx,y) where y is the bit (0—7) and xx the byte (0—31 ) of sense data to be checked. 



Parameters for the MODE Command, (part 1 of 2). 
Table F-2-B 
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RMS 



Operand 


Description 


STATUS 
Not applicable' 
to Models 1 15 
and 125 


On SYS LOG a report is printed which indicates: 

• The type of facility used (HIR, ECC) 

• System mode of operation 

• Current error count 

• Error count threshold 

• Current elapsed time 

• Time threshold 

• Number of buffer pages deleted. 
The status report formats are: 

HIR,-i >,aaaa/eeee,bbbb/tttt 

For the Model 135: 

Ho} 

For the Model 145: 

R M 
ECC, Q, C,aaaa/eeee,bbbb/tttt 
F or the Mod els 1 55-1 1 and 1 58 : 

ECC,J y ,aaaa/eeee,bbbb/tttt 

BUF DLT=XXX 

where: 

aaaa = Current error count 

eeee = Error count threshold 

bbbb = Current elapsed time 

tttt = Time threshold 

xxx = Total number of inoperable buffer pages deleted. 


HIR 

Note applicable » 
to Models 1 15 
and 125 


Hardware Instruction Retry. This operand changes the mode of the HIR facility to R or Q and/or modifies 

the error count threshold and/or time threshold. 

Note: When HIR is placed in quiet mode, ECC also goes into quiet mode. 


ECC 

Not applicable 
to Models 1 15 
and 125 


Error Correction Code. This operand changes the mode of the ECC facility to R or Q, and/or modifies the 
error count threshold and/or time threshold. ECC,R and ECC,Q are the only valid modes of diagnosis for the 
Model 135. If ECC is specified for a Model 145, M or C must also be specified. ECC can also place the 
Model 145 control storage in threshold mode. 

Note: Use of the Error Correction Code (ECC) in full recording mode may cause severe system degradation. 
Thus, the (ECC, M/C,R) operand combination of the mode command should only be used by the customer 
engineer or at his request. 


R 


Recording Mode 

MODE R -places both HIR and ECC in recording mode. 

MODE HIR.R — places HIR in recording mode. 

MODE ECC,M r R (Model 145) — if HIR is already in recording mode, main storage is placed in recording mode. 

MODE ECC,C,R (Model 145) — if HIR is already in recording mode, control storage is placed in recording 

mode. 

MODE ECC, R (Models 155-11 and 158) — if HIR is already in recording mode, it places ECC in recording 

mode. 


Q 

Not applicable 
to Models 1 15 
and 125 


Quiet Mode 

MODE HIR,Q - places both HIR and ECC in quiet mode. 

MODE EEC,Q (Model 135, 155-1 1 and 158) places ECC in quiet mode. 

MODE ECC,M,Q (Model 145) — places main storage in quiet mode. 

MODE ECC,C,Q (Model 145) — places control storage in quiet mode. 


Mor C 

Note applicable 
to Models 1 15 
and 125 


Main or control storage: M or C is only valid for the Model 145. 
M or C must be specified when ECC is specified for the Model 145. 
M indicates main storage and C control storage. 


TH 


Treshold Mode: on the next occurrence of an ECC control storage error, control storage is placed in quiet 
mode. TH is only valid for the Model 145 if ECC,C is specified. TH places the Model 145 control storage 
ECC in threshold mode. 


E=eeee 
T=tttt 


Values entered for E and T must be within the following decimal ranges: 

E-8 (initial value) through 9999 (Error Count threshold) 

T-8 (initial value) through 9999 (Time threshold) 

The IBM-supplied value is 8. . 

Note: Whenever HIR is in quiet mode, ECC mode must not be changed. 

For the Model 135, the only valid mode commands are: 

MODE CE,... 

MODE STATUS 

MODE ECC,Q 

MODE ECC,R 



Table F-2-B Parameters of the MODE Command, (part 2 of 2). 
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The EREP program edits and prints error statistics records that have been stored on ER EP 

the recorder file (SYSREC) by RMSR. 

Note: Not applicable to the 
System Requirements Models 1 15 and 125 using 

a supervisor that does not 
Before it can be executed, EREP must be cataloged to the core image library. support the RMSR function. 

Check with the person in your installation who is responsible for creating or 
maintaining the core image library to ensure that the EREP program is cataloged. 
The link-edit statements for cataloging EREP are in the DOS/ VS System Generation 
manual. 

The EREP program is a modular, self -relocating program. If the supervisor is 
batched-job only, however, EREP must be link-edited to the end-of-supervisor 
address. It can run in a real or virtual partition using standard job control 
statements. When the environmental data is needed or the SYSREC file becomes 
full, EREP can be executed from SYSLOG or SYSIPT. 

EREP can perform any combination of the following options: 
Edit/print the entire SYSREC file 
Create or update the history/RDE tapes 

Selectively retrieve records from the SYSREC file or history/RDE tapes 
for editing and printing 
Summarize the SYSREC file 
Create or update a TES history tape 
Edit/print TES data from the SYSREC file 
Summarize TES data from the SYSREC file or history tape 
Clear the SYSREC file. 

Tables F-3-A and B show how the options are selected and table F-3-C lists the 
logical unit assignments required by EREP. Table F-3-D and the text following 
gives a detailed description of these options. Flowchart F-3-F shows the procedure 
for executing EREP. 
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EREP 



EDIT 

CLEAR 

SUM- 



OPTION \ HIST 



[,NEW] [,2] 
UPIMEW 



TES 

SELECT 
RDESUM 



-GROUP 



OPTION TES 



Table F-3-A. The options for TES (Tape Error Statistics) 



[,NEW] LPRINT[,SUM[,SUMTAPE]] [ 

[,SUM[,SUMTAPE] [,VOL] 
,NOTAPE/,PRINT[,SUM[,SUMTAPE] 
\,SUM[,SUMTAPE] [,VOL] 



,VOL] 
] [,VOL]l 



GROUP= 



DISK 

DISKETTE 

TAPE 

MICR/OCR 

UNITREC 

TP 

CPU 

2715 

ALL 



CPU=xxxxxx,yyyy 

where xxxxxx = the CPU volume serial 
number 
yyyy = the CPU model number. 



Table F-3-B. Parameters for the SUM option. 



LOGICAL UNIT 


COMMENTS 


SYSIPT 


Optional 


SYSLOG 


Required, must be assigned to a 3210, 3215 or 
a Model 125 video display unit 


SYSREC 


Required 


SYS007 
SYS008 


Optional; must be assigned to a magnetic tape unit 
when a TES option is specified. 


SYS009 


Optional; must be assigned to a magnetic tape unit 
for history /RDE options. 



Table F-3-C. Logical units required by EREP. 
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OPTION 


RESULT 


OPTION EDIT 


Edits and prints SYSREC onto SYSLST. 


OPTION CLEAR 


1. Edits and prints SYSREC onto SYSLST 

2. Clears SYSREC. 


option sum 

/disk 
diskette 

TAPE 
1 MICR/OCR 
GROUP= < UNITREC < 
TP 
CPU 
2715 

\ ALL J 

CPU=xxxxxx,yyyy 


| 


Prints the summarization of SYSREC onto SYSLST. The file is summarized by the 
hardware group(s) listed in the GROUP parameter. 

If records from multiple CPUs appear on the SYSREC file, specify the serial number 
(xxxxxx) and model number (yyyy) of the CPU whose records you wish to have 
summarized. If CPU data is not supplied, records from all CPUs appearing on the 
SYSREC file are summed together. 


OPTION HIST,NEW[,2] 


1. Creates the history /RDE tape on SYS009 

2. Clears SYSREC. 


OPTION HIST[,2] 


1 . Updates the history /RDE tape on SYS009 

2. Clears SYSREC. 


OPTION EDIT 

followed by 

OPTION HIST.NEW or OPTION HIST 


1 . Edits and prints SYSREC onto SYSLST 

2. Creates or updates the history /RDE tape on SYS009 

3. Clears SYSREC. 






OPTION TES.NEW 


Creates a TES history tape on SYS007. 


OPTION TES 


Updates a TES history on SYS007. 


OPTION TES,NOTAPE,PRINT 


Edits and prints tape error data from SYSREC onto SYSLST. The data is printed in 
the detail tape unit format. 


OPTION TES,PRINT,NEW 


1 . Creates a TES history tape on SYS007 

2. Edits and prints tape error data from SYSREC onto SYSLST in the detail 
tape unit format. 


OPTION TES.PRI NT 


1 . Updates the TES history tape on SYS007 

2. Edits and prints tape error data from SYSREC onto SYSLST in the detail 
tape unit format. 


OPTION TES,NOTAPE,SUM 


Prints the summarized tape data from SYSREC onto SYSLST in the detail tape 
unit format. 


OPTION TES,NOTAPE,PRINT,SUM 


1 . Edits and prints the tape error data from SYSREC onto SYSLST in the detail 
tape unit format. 

2. Prints the summarization of the tape data from SYSREC onto SYSLST in the 
summarized tape unit format. 


OPTION TES,SUM, VOL 


1 . Updates the TES history tape on SYS007 

2. Summarizes the tape error data on SYSREC by volume serial number. 


OPTION TES,PRINT,VOL 


1. Updates the TES history tape on SYS007 

2. Edits and prints the tape error data from SYSREC onto SYSLST in the detail 
volume serial number format. 


OPTION TES,PRINT,SUM,SUMTAPE,VOL 


1 . Updates the TES history tape on SYS007. 

2. Edits and prints the tape error data from SYSREC onto SYSLST in the detail 
volume serial number format 

3. Summarizes the tape error data on the history tape and prints it on SYSLST 
in the summarized volume serial number format. 


OPTION TES,NOTAPE,SUM,SUMTAPE 


Summarizes the tape error data on the history file and prints it on SYSLST in the 
summarized tape unit format. 


OPTION SELECT (see note 1) 


Selectively prints records from SYSREC onto SYSLST. 


OPTION SELECT .TAPE (see note 1) 


Selectively prints records from the history /RDE tape onto SYSLST. 


OPTION RDESUM 
(none) 


Summarizes the IPL, EOD, MCAR, CCH, and Unit Check records for a specified 
period of from one to 30 days. These records are on the history /RDE tape 
(see note 2). 

Edits and prints SYSREC onto SYSLST. 


Note 1. Records are selected by specifying select parameters. 

Note 2. RDESUM does not summarize across multiple volumes. If EOF is encountered before the entire requested reporting period 
has been covered (this can be checked through the end date printed on the RDESUM listing), rerun RDESUM using the next 
volume history /RDE file nad the same reporting period you specified during the first RDESUM execution. A listing with 
the remainder of the requested information is thus generated. 



EREP 



Table F-3-D. The EREP options 
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EREP Description of E REP Options 

EDIT 



The EDIT option causes EREP to edit and print the contents of the SYSREC 
file on SYSLST. The unit check records are displayed first and are grouped by 
CUA (channel and unit address) within each device group (unsupported, tape, 
disk, TP, unit record, MICR/OCR). 

After the unit check records, the channel check, machine check, 2715, and 
IPL/EOD records are displayed. Retain these printouts for problem determination. 

EREP displays IBM 2715 error records from the SYSREC file in this order: 

1 . Disk adapters 

2. 2790 loop adapter 

3. MPX adapters 

4. 2750 adapters. 

5. BSC adapters. 

The special code records are grouped for editing and printing by area station 
address, CUA, and special code. All area station records on SYSREC are 
summarized by device address, area station, ID, and CUA during editing and 
printing. 

EREP EDIT can execute in a 14K partition, but performance may be improved by 
allocating more than 14K (up to 42K) to the EREP partition. Storage allocation 
should be increased in blocks of 4K because the tables that EREP EDIT uses are 
each 3.5K in size. This applies only when EREP is executed in real mode. 

CLEAR: The CLEAR option causes EREP to clear (reset) the entire SYSREC file 
for RMSR recording. If the CLEAR option is specified by itself, the EDIT option 
is forced. CLEAR is always the last EREP function performed. CLEAR is forced 
if HIST, or HIST with optional parameters, is specified. 

Note: If a hard I/O error occurs on SYSREC while the CLEAR function of EREP 
is running, EREP will abnormally end and the operator should re-IPL the system. 
In a MPS system, it may be undesirable to re-IPL. If you do not re-IPL, however, 
the contents of the SYSREC file will be unpredictable. 
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SUM 

The SUM option allows hardware groups on SYSRES file to be summarized. 
This function can: 

• Accumulate certain bits and bytes in CPU logouts within MCAR/CCH 
records 

• Accumulate statistical and sense byte data from unit check records 

• Summarize area station data in 271 5 error records by device address, area 
station, ID, and channel and unit address. 

The SYSREC file may be summarized, or one or more hardware groups may be 
summarized. The GROUP parameter should immediately follow OPTION SUM. 



Hardware Error Recording and Recovery 

EREP 



Note: This option is only 
applicable to the Model 145. 



DISK 

DISKETTE 

TAPE 
™~, ,„ j MICR/OCR 
GROUP= *< UNITREC 

TP 

CPU 

2715 

ALL 



These entries separated by commas may be made in any order. If the GROUP 
parameter does not follow OPTION SUM or if it contains an error which the 
operator does not correct, the EREP program summaries the SYSREC file for 
the tape hardware group. 

If the SYSREC file contains records of multiple CPUs, the CPU whose records are 
to be summarized must be defined by entering 

CPU = xxxxxx,yyyy 

in which xxxxxx = the CPU serial number 
yyyy = the CPU model number. 

If no CPU is provided, records from all CPUs appearing in the SYSREC file are 
summed together. 

You can execute the SUM option more than once during an EREP run if you 
enter the option and parameter control statements via SYSLOG. After the 
summary is performed with one set of parameters, the message 

3E05A ENTER SUMMARY PARAMETERS 
is printed on SYSLOG. You may enter the parameters for another summary at 
this time, or end execution of the SUM function by responding with CANCEL 
and pressing the END or ENTER key. 

If GROUP=ALL is specified, EREP does not ask for additional parameters because 
a summary of all records is made. 

When the summary has been completed, EREP processes the next option, if any. 

It is possible to reduce the processing time for the SUM function by allocating more 
main storage (in blocks of 8K) to the partition in which EREP is to run. The root 
phase requires 2K and each transient 8K. The disk, tape, and unit record group use 
two transients; other hardware groups require only one transient. 

When 2715 is specified in the GROUP parameter, the 2715 records are summarized 
before any other hardware group. The 2715 group uses 10K of storage, even if 
more storage is available. If not all the 27 15 records can be processed in the 10K 
partition, those that can be are processed, after which the transient is reloaded and 
the next 2715 records are processed. This is done until all 2715 records are 
processed. 

In the 8K partition, the TP group can be process records for up to 60 distinct 
terminal names at one time. If more than 60 terminals are to be summarized, the 
file must be read more than once. If more than one hardware group is specified in a 
10K partition, the transients overlay each other and the file must be read as many 
times as there are transients. 




\ 



Note: This applies only to 
EREP executed in real mode. 
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SELECT 

By means of the specified search parameters, EREP selects records to be printed. 
The SELECT option initiates the search for these records on SYSREC; for 
example, SELECT, TAPE causes a search of the history tape to be performed. 
The parameters of the SELECT option are called select parameters; they are 
checked for validity but not for logical relationship. For example, although an 
MCAR record has no VOL field, the parameters 

TYPE=MCAR 
VOL= 123456 

are considered valid. 

The possible select parameters are listed in the table below: 



SELECT PARAMETER 


RESULT 


CPU=xxxxxx 


All error records associated with a CPU may be selected for printing by entering the 
six digit CPU serial number. 


TYPE= - 


"MCAR" 

CCH 

IPL 

EOD 

TP 

UNIT 
-1275 J 


- 


A specific type of error record may be selected for printing. Any number of different 
types may be selected for each search. 


fyyddd f yydddl 
DATE= j yyddd J" 


All recordings made within a time span (measured in days) may be selected for printing. 
If two dates, separated by a comma, are specified, all recordings made in that time span 
are selected. If only one date is specified, all recordings made on that day are selected 
for printing. 


TIME hhmm,hhmm 


All recordings made within a time span (measured in hours and minutes) may be 
selected for printing. 


JOB=xxxxxxxx 


All recordings made during the execution of a specific job may be selected for 
printing by specifying the eight-byte jobname from the job statement. 


VOL=xxxxxx 


The error records for a specific volume may be selected for printing by entering the 
six-byte volume serial number. 


TERM=xxxxxxxx 


The error records for a terminal may be selected by entering the eight-byte terminal 
name. 


CUA=xxxx 


Records may be selected for printing by entering the channel and unit address 
(in hexadecimal) or the line number for TP. 


DEVICE=xxxxxx 


The records associated with a specific type of device may be selected by entering the 
device type code (for example, 1403, 1442N1 ). 


FORMAT=TES 


Whenever a tape (2400 or 3400-series) error record is encountered, it is printed in the 
detail TES format by volume serial number. If FORMAT=TES is not specified, all 
tape error records are printed in the unit check format. 


Tare a ~) 
sel2715= j adapter l 
[special J 


The 2715 records are printed in area station format if the SEL2715 parameter is not 
specified. If printing by area, adapter, or special is required, however, the SEL2715 
parameter must be specified. 



[Table F-3-E. The select parameters. 



You may enter any combination of parameters; the EREP program assumes that 
you will only enter select parameters that apply to the records you want. If no 
select parameters are specified with the SELECT option, the MCAR records are 
selected and printed. 

The SELECT option can be executed more than once during an EREP run if the 
option and parameter control statements are entered via SYSLOG. After selective 
retrieval, when one set of select parameters has been completed, the message 

3E03A ENTER SELECT PARAMETERS 

is printed on SYSLOG. At this time, you may enter a new set of select parameters 
to execute the selective retrieval or you may end selective retrieval by responding 
with CANCEL and pressing the END or ENTER key. 
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RDESUM EREP 

The RDESUM option provides a summary of information about system operation 
during a specified 1 to 30 day period. This summary is created by searching the 
history/RDE tape, mounted on SYS009, for IPL, EOD, MCAR, CCH, and unit 
check records, after which these records are edited and printed on SYSLST. The 
information provided by the RDESUM option includes: 

• The starting and ending dates of the report. 

• The date, time, reason, and subsystem responsibility for each IPL. 

• The average run time between IPL and EOD (or between two consecutive IPLs 
if the ROD command was not issued to create an EOD record) for the 
specified interval. If specified, the number of IPL records that occur in the 
cluster interval, (see note) 

• The subsystem responsibility and number of times a subsystem caused a 
System Recovery Incident (a recoverable error that may cause system 
degradation) or a System Incident (an unrecoverable error that caused 
system failure). 

• If the history/RDE tape contains no records within the specified dates, an 
error message is printed and the report is terminated. 

• IPL records are not counted in the reports of sub-systems SI (System 
Recovery Incidents) 

• If an IPL record with a reason code of UN, IE, IM, ME or DF is immediately 
preceeded on the tape by an SRI that occurred within 30 minutes of the 
IPL, the SRI may be reclassified as an SI. The SRI is reclassified if (1) the 
subsystem ID specified for the IPL is the same as the device type of the SRI, 
or (2) if the subsystem ID is unknown (00). 

• Multiple SRIs on the same device are counted as a single SRI until there is a 
ten minute interval without an incident or an IPL record. 

• If an SI occurs within ten minutes of the IPL record following an SI, the SI is 
counted as a multiple occurrence of the first SI regardless of the subsystem 
involved. Intervening SRIs are ignored. 

• If 16 sequence errors occur on the history/RDE tape, RDESUM is 
terminated; if fewer than 16 sequence errors occur, the out-of-sequence 
records are ignored. 

Note: Clustering is the process of searching for multiple IPL records that have 
occurred within a specified number of minutes. Clustering can be used to detect 
multiple false starts that may distort other information provided by RDESUM. 

RDESUM is executed when the appropriate option card is encountered. The control 
information, including the start date for the report, the end date, the clustering 
interval if clustering is desired, and the company name, is entered once the 
EREPRDE phase is in main storage. The control information is entered in response 
to prompter messages. 

RDESUM does not summarize across multiple volumes of a history/RDE file. If 
EOF is encountered on the input tape, RDESUM goes to EOJ and the report 
printed reflects the information available from the start date to the last record 
on the tape. There may be some inaccuracy in the average run time per IPL 
(because RDESUM does not know when the EOD or next IPL record will occur, 
it uses the time of the last error record to compute the IPL period), but no other 
information is lost. 

RDESUM can be executed again for the next volume in the history/RDE file to 
obtain the remainder of the information for the desired reporting period. The 
previously specified period may be used on the subsequent volume because 
RDESUM starts with the first record on the tape if the specified start date is 
earlier than the date of the first record. 
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E R EP The following rules govern the method for summarizing RDE information: 

• If the history/RDE tape does not contain information for a portion of the 
required time period, only those dates on the tape that fall within the time 
period are processed. The actual dates processed are reflected on the 
summary listing. 

• If the starting date is defaulted, the first record on the tape is used to start 
the report. The report is stopped with the specified end date or, if that date 
is more than 30 days from the date of the first record processed, the 
thirtieth day processed. 

• If the end date is defaulted, the report is stopped with the last date on the 
tape or, if that date is more than 30 days from the starting date, on the 
thirtieth day processed. 

HIST or HIST with Operands 

This option copies the data on the SYSREC file to the history/RDE tapes. All 
records on the tape(s) appear in chronological order. If an unrecoverable I/O 
error occurs while a record is being read from the SYSREC file, the record is 
ignored and processing continues with the next sequential record. If the data fills 
the complete tape, the message 

3E15ATAPE FULL, MOUNT NEW TAPE 

is printed on SYSLOG. The operator must mount a new tape and press END to 
continue processing, or he may respond with CANCEL and press END to cancel 
the HIST option. 

The tape must be mounted on SYS009. SYS009 must be assigned to a tape drive 
before EREP is executed. The tape contains standard labels that are checked 
before the history/RDE tape is written. If the wrong tape is mounted, the message 

3E31A WRONG TAPE, MOUNT CORRECT TAPE 

is printed on SYSLOG, Mount the correct tape and press END to continue 
processing, or respond CANCEL END to cancel the HIST option. When the HIST 
option is specified, the CLEAR option is forced. The SYSREC file is cleared 
after the history/RDE tape has been created or updated, thus preventing 
redundant data from being transferred to the history/RDE tape the next time the 
HIST option is executed. 

HIST,NEW,[,2] : This option causes EREP to create a history file on the tape unit 
assigned to SYS009. If 2 is also specified, a second history file is created on the 
same tape unit for RDE data. The data contained on both tapes is identical. The 
tape(s) contain the contents of the SYSREC file. The SYSREC file is cleared after 
all options have been executed. 

HIST,UPNEW: This option causes the tape file mounted on SYS009 (either 
history or RDE) to be updated, after which a new tape file is created. If UPNEW 
is specified, TLBL information for creation and updating must be included in the 
job stream. The SYSREC file is cleared when all options have been executed. 
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TES or TES with Operands E R E P 

The TES options provide for the editing and printing of the tape error records on 
SYSREC and the summarizing of tape data found on either SYSREC or the history 
file. 

To enable this option to be used a work or scratch tape must be mounted on a tape 
unit assigned to SYS008. This option can also select tape error data from the 
SYSREC file and create a TES history tape with the same format as the previously 
supported ESTV tape file. All records on the tape appear in chronological order. If 
an unrecoverable I/O error occurs while reading a record from the SYSREC file, 
the record is ignored and processing continues with the next sequential record. If 
the data fills the complete tape, the message 

3E15ATAPE FULL, MOUNT NEW TAPE 

is printed on SYSLOG. The operator must mount a new tape and press END, or he 
may respond CANCEL END; the latter response causes tape updating to be 
discontinued, but TES records are still printed. 

The tape must be mounted on SYS009. SYS009 must be assigned to a tape drive 
before EREP is executed. The tape contains standard labels that are checked 
before the history/RDE tape is written. If the wrong tape is mounted, the message 

3E31A WRONG TAPE, MOUNT CORRECT TAPE 

is printed on SYSLOG. Mount the correct tape and press END to continue processing, 
or respond CANCEL END to cancel the TES option. The history/RDE tape and 
TES history tape should be created or updated during the same EREP run. If the 
HIST option is specified without the TES option, the SYSREC File is cleared after 
HIST has been executed, and the TES data is lost. If you wish to maintain both 
these history tapes and the TES and HIST options are not specified together in 
one EREP run, the data on the TES history file may be redundant or lost. 

TES,NEW: This causes EREP to create a TES history file on the tape unit 

assigned to SYS007. The tape file contains tape error data from the SYSREC file. 

The tape error data on the tape has the same record format as the previously 

supported ESTV tape file. Use ESTVUT utility program to print this tape file. 

TES: EREP updates the TES history tape on SYS007. 

TES,NOTAPE,PRINT: Causes the tape data on SYSREC to be edited and printed 

into SYSLST. Data is printed in the detail tape unit format. 

TES,PRINT,NEW: A new TES history tape is created on SYS007, after which the 

tape error data on SYSREC is edited and printed on SYSLST. The data is printed 

in the detail tape unit format. 

TES,PRINT: The TES history tape, which is mounted on SYS007, is updated. 

The tape error data on SYSREC is then edited and printed on SYSLST in the 

detail tape unit format. 

TES,NOTAPE,SUM: The tape error data on SYSREC is summarized by tape drive. 

TES,NOTAPE,PRINT,SUM: The tape error data on SYSREC is edited and printed 

on SYSLST in the detail tape unit format. Then the tape error data on SYSREC is 

summarized by channel and unit and printed on SYSLST. 

TES,SUM,VOL: The TES history tape on SYS007 is updated. Afterwards the 

tape error data found on SYSREC is summarized by volume serial number. 

TES,PRINT,VOL: The TES history tape mounted on SYS007 is updated. The 

tape error data on SYSREC is edited and printed on SYSLST in the detail volume 

serial number format. SYS007 is used as a work tape and the detail records are 

printed in sequence by volume serial number. 

Four examples of processing tape error statistics using EREP are given in 
Appendix 0. 
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EREP E REP History Tapes 



There are three types of EREP history tapes: the History tape, the RDE tape, and 
the TES history tape. The History and RDE tapes are created and updated from the 
SYSREC file and contain all the record types found on the SYSREC file. The TES 
history tape is also created from the SYSREC file, but contains only tape error 
records. If your installation has the History/RDE tapes and a TES history tape, you 
should create (or update) all the history tapes in the same run. If this procedure is 
not followed, the TES history tape may have redundant or missing data. 

Retain the History and TES history tapes for those persons who work on problem 
determination. The History tape can be used as input for certain online test 
programs of OLTEP. (See the OLTEP manual.) The TES history tape can be printed 
with the ESTVUT utility program. Retain the RDE tape; it will be used by IBM. 



History/RDE Tape 

The History/RDE tape is created and updated using the EREP history option. This 
tape contains RDE data only if ERRLOG=RDE is specified at system generation. A 
magnetic tape unit assigned to SYS007 must be used for this function. EREPNEW 
must be the filename that is used when a tape is created, and EREPUP when a tape 
is updated (both TLBL cards must be included for UPNEW). When the tape becomes 
full or when a second tape must be mounted, the operator is notified via SYSLOG. 

Note: If EREP is link-edited as a self-relocating program, an LBLTYP card is 
needed when EREP builds a history /RDE tape. 

TES History Tape 

The TES history tape is created and updated using the EREP TES options. A 
magnetic tape unit assigned to SYS007 must be used for this function. The filename 
of the tape file must be TAPEIN when the file is created and the file is updated. 



Creating the History Tapes 

You can create a history tape only if DOS/VS has recorded errors on SYSREC. 
The EREP program allows you to create or update the three types of history tapes, 
three types of history tapes. 

You can create the History/RDE tape by specifying OPTION HIST, NEW, and 
update it by specifying OPTION HIST. 

If a System/370 RDE tape is to be processed, the message 3E16A is printed on 
SYSLOG after the History tape is written. This message instructs you to replace 
the History tape reel with the RDE tape reel and then respond to the message. A 
response of END will cause the RDE tape to be processed and response of CANCEL 
END will cancel only the HIST option. Any other response will cause the system 
to reissue message 3E16A. 

In addition, you can create a TES history tape, which contains only tape error 
records. If you want to maintain a TES history tape, create (or update) it in the 
same EREP run in which you create (or update) the History/RDE tape. You can 
create the TES history tape by specifying OPTION TES,TAPE,NEW, and update 
it by specifying OPTION TES, TAPE. 
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Processing the tape error statistics with EREP E R E P 

The EREP (Environmental Recording, Editing, and Printing) program provides 
processing options for the tape error statistics records on SYSREC. 

Tape records can be edited and printed or summarized, together with the order 
records on SYSREC; you may also choose to have only the tape error records of 
the file selected or summarized. If the SYSREC file has been used to create a 
history/RDE tape, the records on that tape contain the same information as the 
SYSREC file contained. In this case the tape error statistics records can be selected 
or summarized from the history/RDE tape file. 

The SYSREC file may also be used to create a TES history tape. This tape contains 
tape error statistics records only. These records have the same format as the 
records of the former ESTV disk file; thus only part of the information recorded 
on the SYSREC file for tape error statistics is written on the TES history file. The 
information written on the TES history file consists of: 

Date the record was collected 

Physical address of the device on which the tape volume was mounted 

Number of temporary read errors 

Number of temporary write errors 

Number of permanent read errors 

Number of permanent write errors 

Number of error gaps encountered 

Number of noise blocks encountered 

Number of cleaner actions taken 

Number of SIO instructions issued 

Volume serial number if the tape was a standard labeled volume 

Block length if the volume contained fixed-length blocked records 

Tape density of the tape volume. 
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EREP 



The history /RDE tape and the TES history tape must always be updated in the 
same run. Failure to update both these tapes on the same run may result in 
redundant or lost data on the TES history tape. When PRINT is specified, the 
detail records on SYSREC are printed on SYSLST. When SUM is specified, the 
tape error statistics are summarized on either the history tape or SYSREC. 

It is possible to print or summarize tape error statistics by volume serial number 
or by tape drive address. 

When tape error statistics are summarized by volume serial number, it may be 
possible to reduce processing time by allocating more main storage to the EREP 
partition. Approximately 90 distinct volumes can be summarized in a 10K 
partition. When the SYSREC file contains recordings for more than 90 distinct 
volumes and EREP is run in a 10K partition, the SYSREC file is read and 90 volumes 
are summarized; then the SYSREC file is processed again and the remaining (or 
next 90) volumes are summarized. 

If you want to reduce processing time when there are more than 90 volumes, 
therefore, you must allocate enough storage, thus allowing all volumes to be 
summarized on only one read-through of the SYSREC file. Approximately 12 
additional volumes can be processed for each IK added to the partition. To 
calculate the number of volumes that can be summarized in a particular partition, 
use the following formula: 



80 bytes 

if tape is - 2740 

assigned 



82 
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Processing the TES H istory Tape with the ESTVUT Utility Program E R EP 

When a TES history tape is created from the data on SYSREC, ESTVUT (the 
ESTV Dump File Program) is used to process the data on the TES history tape. 
This utility program dumps the TES history file on SYSLST. 

ESTVUT consist of one module that has to be cataloged in the core image library. 
The module name to be used in the INCLUDE statement for this routine is 
IJBTESUT. 

Control Cards necessary to run ESTVUT. 

ESTVUT can be executed either from a card reader or from SYSLOG. An example 

of the job control statements required for ESTVUT is: 

//JOB ESTVDUMP 

// ASSGNSYS005,X'18T 

// ASSGN SYSLST,X'00E' 

//TLBLTAPEIN 

// LBLTYPTAPE 

// EXEC ESTVUT 

/* 

/& 

Symbolic Unit Assignments: Every sumbolic unit required for execution of the 
ESTVUT program must be assigned either temporarily for one job, or permanently. 

• SYS005 must be assigned to the magnetic tape unit on which the TES 
history file is mounted. 

• SYSLOG must be assigned to a 3210, a 3215 or a Model 125 video display 
unit for all executions of ESTVUT in order to log inquiries and accept replies. 

Label information: Label information must be available to the system whenever 
the devices are used in the execution of ESTVUT 

• The first operand of the TLBL statement for the input tape must be 
TAPEIN 

• A LBLTYP for tape is required if the program uses tape and has been 
cataloged as a self-relocating program (+0 on the PHASE card). This 
statement reserves space for processing standard label information. 

Contents and format of printed output 

When the operator specifies a printer as the output device, the collected error 
statistics are formatted and printed as illustrated below: 




VOLUME 




TIME 


CHANNEL 


TEMP 


TEMP 


PERM 


SERIAL 


DATE 


OF DAY 


/UNIT 


READ 


WRITE 


READ 


xxxxxx 


yr/day 


hr.mn.sc. 


cuu 


nnn 


nnn 


nnn 


PERM 


NOISE 


ERASE 


CLEANER 


SIOS 


TAPE 


BLOCK 


WRITE 


BLOCKS 


GAPS 


ACTIONS 


USAGE 


DENSITY 


LENGTH 


nnn 


nnn 


nnn 


nnn 


nnnn 


nnn 


nnnn 



Each page of output contains 50 lines of data. 

On the last page, a message is printed below the last line of data. The message is: 
ESTV TAPE FILE DUMPED 
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E R E P Executing EREP 



Execute the EREP program at the request of the customer engineer or in response 
to an instruction in an error message. The operator commands necessary to 
execute EREP through either SYSLOG or SYSRDR are: 

PAUSE BG,EOJ 

//TLBL EREPNEW (see note 1) 

// EREPUP 

//TLBL TAPEIN (see note 2) 

TESUP 
//ASSGN SYS007,X'cuu' 
//ASSGN SYS008,X'cuu' (see note 3) 

// LBLTYP TAPE 
//EXEC EREP 

Note 1: This card is necessary only if you want to create or update either a 

history tape or a history tape and a Model 145 RDE tape. Use EREPNEW when 

creating and EREPUP when updating. 

Note 2: This card is necessary only if you are creating or updating the TES 

history tape. Use TAPEIN when creating and TESUP when updating. 

Note 3: This control card is necessary if you are updating or creating any of the 

history tapes (History tape, RDE tape, or TES history tape). 

Then EREP issues a message to the operator via SYSLOG or SYSIPT that is to be 
used for entering the EREP options. 

3E1ID ENTER OPTION SOURCE ,C=CARD, 
S=CONSOLE,N=NONE 

The operator must respond with one of the following: 

• C followed by END for SYSIPT 

• S followed by END for SYSLOG 

• N followed by END for the default option, EDIT. 

The default will be N END or just END, and the result will be the editing and 
printing of the SYSREC file. If the operator response is C END or S END, the 
system awaits option data on either SYSIPT or SYSLOG. Enter CANCEL END 
if you wish to cancel the job at this time. 

If any response other than C, S, N, CANCEL, or END is entered: 

3E25I INVALID RESPONSE 
will appear on SYSLOG and message 3E1ID is reissued. 

Entering EREP options 

EREP options can be entered through SYSLOG or through SYSIPT. 

If you use the console printer-keyboard for input, you respond to the prompter 
messages. 

There can only be one option per line (SYLOG entry) or one option per card (card 
entry). Only one option card for each type of option (EDIT, CLEAR, SUM, HIST, 
TES, and SELECT) may be entered in an EREP run. However, when entered via 
SYSLOG, the SUM and SELECT options may be executed more than once in a 
single EREP run. Table F-3 lists the EREP options. 

You can alter the order of EREP actions by specifying two options. For example: 

OPTION EDIT Edit and print the SYSREC file . 

OPTION HIST Update the history tape, and then clear the file. 

*The END key on the Model 125 is replaced by the ENTER key 
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EREP 



Yes 



Job stream via 
SYSRDR 



Job stream via 
SYS LOG 



3E11D ENTER OPTION SOURCE, C=CARD, 
S=CONSOLE, N=NONE 



When RMS=NO 

Run EREP only when hardware 
failures are detected on channel 
attached input/output devices, 
magnetic tape units and TP. 
Use MAINTENANCE LOG 
ANALYSIS to display hardware 
failures. F-5-F. 



F-3-F 



Enter C 
Press End 



Select option 
Enter S 
Press End 



Enter N 
Press End 



System waits for EREP options 
to be entered, for details see F-5 



f 




Options entered 
via SYSIPT 



Options entered 
via SYS LOG 



Default option EDIT 

selected. 

Refer to table F-3-D 




Yes 



Refer to table F-3-A 



Yes 



3E05A ENTER SUMMARY PARAMETERS 
Refer to table F-3-B 



Yes 



3E03A ENTER SELECT PARAMETERS 
Refer to table F-3-E. 



Option EDIT, CLEAR 
RDESUM, or HIST. 
Refer to table F-3-D 
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E R EP For input from either SYSIPT or SYSLOG , embedded blanks within the operation, 

option, or parameter are not allowed. Misspelled words, syntax errors, duplicate 
option statements and unsupported options are invalid. 

When input is from SYSIPT, these errors will cause 40 bytes of the card to be 
issued to SYSLOG along with the message: 

3E04I INVALID PARAMETER 

or 

3E12D INVALID OPTION 

At this time, you may place a corrected card in SYSIPT and then press END to 
process the desired option. If you do not want to process the card in error, enter 
END and the program will ignore that option card. However, if you wish to cancel 
the job, enter CANCEL END and the EREP job will be canceled. Multiple options 
are allowed by EREP. See figure for a summary of the EREP options. 

Entering options via SYSLOG: When the EREP options are entered via SYSLOG, 
it is possible to execute the SUM and SELECT options more than once during an 
EREP run. After the SUM or SELECT function has executed, the message 

3E03A ENTER SELECT PARAMETERS 

or 

3E05A ENTER SUMMARY PARAMETERS 

is issued to SYSLOG. You may execute the SUM or SELECT function again by 
entering parameters at this time. If you wish to terminate the SUM or SELECT 
option, press END. 

When entering the EREP option via SYSLOG, the entry must not exceed 80 
positions. Enter, in this sequence: 

1. The operation, OPTION 

2. A blank 

3. The option. 

Any parameters should follow the OPTION statement on the next line(s). Repeat 
this procedure for each option; when all options have been specified, enter END to 
continue processing. 

Note: The END key on the Model 125 is replaced by the ENTER key. 
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Entering options via SYSIPT: When entering the EREP options via SYSIPT, EREP 

column 1 must be blank and only one option per card is allowed (for example, 
HIST with UPNEW or with NEW and/or 2 is considered one option). Each option 
may only be entered once for each execution of the EREP program. 

Example job streams for executing EREP: 

//JOB EXAMPLE 1 

//TLBLEREPNEW 

//TLBLTAPEIN 

// ASSGN SYS007,X'cuu' 

// ASSGN SYS008,X'cuu' 

// ASSGN SYS009,X'cuu' 

//LBLTYPTAPE 

// EXEC EREP 

OPTION HIST, NEW 
OPTION TES,TAPE,NEW 

/* 

/& 

// JOBEXAMPLE2 

//TLBLTESUP 

//TLBL EREPUP 

//ASSGN SYS007,X'cuu' 

// ASSGN SYS008,X'cuu' 

// ASSGN SYS009,X'cuu' 

// LBLTYP TAPE 

// EXEC EREP 
OPTION EDIT 
OPTION TES,TAPE 
OPTION HIST 

/* 

/& 
EREPNEW and EREPUP must be the filenames for new history files or for 
updating. TAPEIN and TESUP must be the file names for anew TES history tape 
or an update TES history tape. 




Serviceability Aids. 2.223 



Hardware Error Recording and Recovery 

EREP 




An example of an EREP output obtained after a storage failure. 

The programmer's marks indicate the areas of interest. 

Note: the entry CONTROL WORD ADDRESS is not applicable for the Model 125. 
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When to use EREP EREP 

Your IBM customer engineer will usually advise you when an EREP printout is 
required, and tell you which option to select. 

Under certain hardware failure conditions, a message issued on SYSLOG , for 
example, message 0T1 1W in the DOS I VS Messages manual will request you to 
RUN EREP. 

Other DOS/VS messages that request you to RUN EREP are issued, for example, 
in the following cases: 

• When the first record on the last track of the recorder file is reached, run 
EREP to avoid the risk of losing statistics. 

• When an unrecoverable I/O error on the recorder file occurs while the 
record indicated is being accessed, the record is ignored and processing 
continues. If this error persists, run EREP to retrieve the information from 
the file and recreate the file using different disk extents. 

• When SYSREC becomes full, no further recording occurs until the file is 
purged. To avoid the risk of losing statistics, run EREP. No recycling of the 
file occurs. 

• For system termination situations (for example, a machine check was 
unrecoverable, the channel caused system reset, or two channels are 
damaged) encountered by MCAR/CCH, recording is attempted. Depending 
on the success of recording, the execution of EREP is requested. An attempt 
is made to write a message to the operator. If the attempt is unsuccessful, 
the message code is in low main storage. 

• If the recorder file is more than 90% full at IPL time, the operator is requested 
to run EREP to prevent the loss of pertinent hardware data. 

Another occasion when you may choose to execute the EREP program is when you 
suspect that a hardware error is causing program errors. From the EREP printout 
you are able to detect any hardware failure and inform your IBM customer 
engineer of it. 
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SEREP 

(MODEL 135, 145 or 155-11; 



SEREP is a self-loading, stand-alone program used to: 

1 . Write the logout from real storage to some storage device such as tape for later 
use by the IBM CE 

2. Perform a hard-copy Edit/Print of the logout. 



When to use 

SEREP is primarily an aid provided for the IBM CE to help his offline diagnosis 
of hardware failures. For this reason SEREP need only be executed on the advice 
of the IBM CE or when requested to do so by a message on SYSLOG, or when a hard 
wait occurs and byte 1 of low real storage contains S (X'E2'). 

Flowcharts in Section 3 indicate when to use SEREP during IPL errors or if the 
system enters a hard wait state. 

Not applicable to the Models 115 and 125. 
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Start 



SEREP 
(MODEL 135, 145 or 155-11) 



Before executing ensure 
that there is no system 
activity. 




Yes 



Press 

SYSTEM RESET 



1 



See next page 



Set CHECK CONTROL to 
STOP AFTER LOG 



Press START and wait 
until CPU stops 




Yes 



Punch 3-character address 
(for example, '00D') of re- 
quired output device in cols. 
67, 68, and 69 of last TXT 
card (next to last card in 
SEREP deck) 



Enter SEREP deck 

into card reader and load 

SEREP using IPL procedure 



Yes 




To retry, press RESTART 



When edit is complete, 
write date and time on first 
page of logout 



Re-IPLif job 
processing is 
to be attempted. 



Wait state while executing SEREP 

Normal Waits 

When no output device is specified, or the specified device 
is not ready, the system enters the wait state after loading 
SEREP 

Hard Waits 

An unexpected program check during execution of SEREP 
causes a message to be printed, and the system enters the 
wait state. Retry is attempted by pressing RESTART. Re- 
IPL should be avoided because alteration of PSWs by the 
SEREP program may cause that edit to be erroneous. 

Termination 

When logout is complete, a message is issued and the system 
enters the wait state. If no log is found, a message is issued 
and the system enters the wait state 



F-4-F 



Avoid new IPL procedure. Because SEREP 
might have altered its PSW by this time, a 
re- IPL can cause part of edit to be wrong 



The or 



. .._ only possible operator intervention that 
may be required would be for mounting the 
accumulation tape when the program asks for it. 



The procedure for executing the SEREP program. 



Serviceability Aids. 2.227 



Hardware Error Recording and Recovery 



SEREP 
(MODEL 158) 



Unlike the Models 135, 145, and 155-1 1, the Model 158 has no CPU logout area 
in real storage. Instead of being recorded in that area, certain types of hardware 
errors are recorded on the Log Recording Console File. The SEREP program also 
resides on the console file and can be loaded through its own IMPL procedure by 
using the MANUAL, SERVICE and INDEX frames. When SEREP is loaded, the 
SEREP frame is displayed to enable you to select one of the options. The options 
include: 

• Write the log to tape 

• Edit and print the log 

• Select and process one of eight previous logs. 

How to execute (Edit and print option) 

1 . Press STOP followed by MODE SEL 
The manual frame will be displayed 

2. Type in F2 or press light pen to lozenge ■ SERVICE FRAME 

(If a "hard copy " of the service frame is required on the 3213 printer, press 
COPY key or press light pen to lozenge ■ COPY) 
The service frame will be displayed. 

3. Type in F4 or press light pen to lozenge ■ 4-INDEX FRAME 
The index frame will be displayed as shown below. 

(Using COPY will not generate a hard copy of this frame.) 




-CHANNEL 2 DISPLAY 
-CHANNEL 3 DISPLAY 



-CHANNEL 4 DISPLAY 
-CHANNEL 5 DISPLAY 



-CHANNEL TO CHANNEL 
-EXECUTION ARRAY 
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How to execute . . . continued 

4. Type in F28 or press light pen to lozenge 

■ 28-EXTERNAL DIAGNOSTICS 
The frame shown below will be displayed. 
(Using COPY will not generate a hard copy of this frame.) 
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SEREP 
(MODEL 158) 







5. Press light pen to the lower lozenge until number 08 is displayed at the 
position of the two XX in the example shown above. 

6. Press light pen to upper lozenge on the display 
The program frame will be displayed. 

7. Press REQ key 

8. Respond to messages displayed as shown in the hard copy example below. 



1b8 SEREP, MACHINE CHECK SUMMARY DESIRED? REPLY YES OR NO 



ADY FOR LOG DUMP TO TAPE PORTION OF 



REPLY PROCEED OR CANCEL 



READY FOR EDIT/PRINT OF LOGOUT 
REPLY PROCEED OR CANCEL 



ENTER PRINTER ADR XXX 



END OF SEREP EXECUTION 



(The operators responses are shown in lower case characters.) 

The SEREP frame will be "rolled" onto the display as responses are given. After 

the address of the printer to be used as output device is entered, SEREP output 

will be observed on that printer. 

Note: The output device can be a tape unit, or the console printer. 



Serviceability Aids. 2.229 



Hardware Error Recording and Recovery 



LOG ANALYSIS 
(MODELS 115 AND 125) 



The LOG ANALYSIS facility allows the operator to display statistical data about 
hardware failures that are logged on the DISKETTE. 

The type and amount of detail displayed is selected by entering appropriate 
mnemonics into the MAINTENANCE PROGRAM SELECTION display. The 
sequence of displays is designed to guide the operator from the initial type of 
display selected to displays that provide more detailed data. 

For an interpretation of the data displayed refer to the Central Test Manual. 

The example shown on the opposite page illustrates the sequence of displays 
obtained to display the errors logged by the IPU (Instruction Processor Unit). 



When to use 

Your IBM customer engineer will usually advise you when to use this feature, and 
tell you which display to select. He may require a hard copy for offline analysis 
of all the displays selected, therefore save the hard copy output. 

Under certain hardware failure conditions, a message issued on SYSLOG, for 
example, message .0T1 1W in the DOS/ VS Messages manual will request you 
to RUN EREP. 

For the Models 115 and 125 you should only run EREP when requested to by a 
DOS/VS message. For example when the recorder file is full a message will be 
displayed informing you of this and re questing you to run EREP. Otherwise, before 
running EREP you should first contact your IBM customer engineer, who will then 
advise you on further action as mentioned in the previous paragraph. 



How to use 

To obtain the LOG ANALYSIS display required using fast selection, 

1. Press the MODE SELECT key. 

2. Type in M followed by the associated mnenomics of the analysis to be displayed. 

3. Press the ENTER key. 

By selecting and entering the appropriate mnenomics, the operator can display 
logged errors for a particular input/output device or a particular part of the CPU. 
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Press MODE SELECT 



LOG ANALYSIS 
(MODELS 115 AND 125) 



MODE SELECTION 



R SYSTEM RESET 

C ADDRESS COMPARE 

. PROGRAM LOAD 

T INTERVAL TIMER 

K CHECK-CONTROL 

D STORAGE DUMP 

E ICA LINE MODES 
MODE SPECIFICATION: 



A ALTER/DISPLAY 

I INSTRUCTION STEP 

P RESTART 

M MAINTENANCE 

S STORE STATUS 

U SAVE USAGE COUNTERS 



Enter M and press ENTER 



MAINTENANCE PROGRAM SELECTION 



A= LOG GENERAL 

B = CPU 

C = CARD/PRINT I/O 

D= DISK 

E = ICA 

I = CHANG. DISKETTE 



J =CPU 
K = 1403 
L = 2560/5425 
M = 3504/3525 
N = DISK 
0= ICA 



CE-MAN.CPS 

S = I0P 

U= CRT-SCOPE 

V = l/OEXERS 
X = IPU 

Y = MATRIX S 
Z = MATRIX M 



PROGRAM SELECTION: M R = SYSTEM TEST (ASCP) 



Enter B and press ENTER 




CPU LOG ANALYSIS PROGRAMS 



= SVP BUS-0 LOG I 

C = IPU ANALYSIS I 

D= IPU LOG DISPLAY [ 

E = MSC ANALYSIS I 

F = MSC LOG DISPLAY ( 

G = IOP 8-F ANALYSIS 

H = IOP 8-F LOG DISPLAY 

PROGRAM SELECTION: MB 

):C003 M:X.DA00.4C. 



K = MTA LOG DISPLAY 

L = MSCI LOG ANALYSIS 

M = MSCI LOG DISPLAY 

N = MPX ANALYSIS 

O = MPX LOG DISPLAY; 



Enter C and press ENTER 



CARD/PRINT I/O LOG DISPLAY PROGRAMS 



3504 LOG DISPLAY H= 5425 LOG DISPLAY 



D= 3525 LOG DISPLAY K= 1403 LOG DISPLAY 



F= 2560 LOG DISPLAY M= 5203 LOG DISPLAY 



PROGRAM SELECTION: MC 



Displaying the IPU Log Analysis 
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DISPLAY FRAMES 
(MODEL 158 ONLY) 



This facility enables an operator to display information about hardware failures and 
warn the shift manager of IBM CE immediately about the nature and possible cause 
of the failure. 



Recognizing a hardware failure 

A hardware failure is indicated by a message which 'flashes' on and off at the lower 
right hand corner of the program frame or manual. 

The example below shows a hardware failure indicated by the words STOR CHECK 
on the manual frame. 




After recognizing the failure an operator is able to 'scan' the display frames and thus 
obtain detailed information about the condition of the hardware. This information 
may enable the IBM CE to diagnose the failure immediately and advise on continued 
system operation. He may also advise that the SEREP is executed and request 'hard 
copies' of the display frame on which the failure is indicated to enable an offline 
diagnosis of the failure . 



How to use 

From the program frame: 

1. Press MODE SEL 

The manual frame is displayed 

2. Type in F2, or press light pen to lozenge ■ SERVICE FRAME 
The service frame will be displayed 

3. Type in F4, or press light pen to lozenge ■ INDEX FRAME 

The index frame will be displayed, an example of which is shown in Section 1. 

4. Press light pen to lozenge - CPU DISPLAY 

The first display frame will be displayed, an example of which is shown at the 
top of the opposite page. 



2.232 Serviceability Aids. 



Hardware Error Recording and Recovery 

DISPLAY FRAMES 
(MODEL 158 ONLY) 



How to use 





5. Scan the frame for any characters that flash on and off beside an entry displayed. 
For example, Z-BUS 614250 indicates that the hardware failure is caused by a 
failure in the Z-BUS. 

If a hardware failure is indicated, press COPY to obtain a hard copy of that 
frame and make a note on the hard copy about the error. (Characters that 
indicate an error are not copied by the system.) 

6. Press the key marked f on the keyboard, as illustrated below. 
The next display frame will be displayed. 



CNCL 


1 


< 

2 


3 


4 


% 
5 


t 

6 


> 

7 


8 


( 
9 


) 





+ 
& 


« 


START 


STOP 




H 


Q 


W 


E 


R 


T 


Y 


U 


I 





P 


@ 


r 




MODE 
SEL 


IRPT 




REQ 


LOCK 


A 


S 


D 


F 


G 


H 


J 


K 


L 


! 


1 




, i 


J 


1 






COPV 


SHIFT 


Z 


X 


C 


V 


B 


IM 


M 






— I 


7 

/ 


SHIFT 






« 








KEYBD 
RESET 








ENTER 







7. Repeat steps 5 and 6 until all display frames have been scanned and hard copies 
made of those containing information about the failure. 

8. Press CANL to obtain the program frame. 



When to use 

1. After recognizing a hardware failure as shown in the example above. 

2. On advicetfrom your IBM CE. 
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OLTEP 



IBM provides a set of device test programs that run under control of DOS/VS. 
These test programs and the online test executive program form the online test 
system. The Online Test Executive program (OLTEP) is an interface between the 
system and the online test programs (OLTs) and communicates with the operator 
during the running of tests. 

Some uses: 

• Diagnosing I/O errors 

• Verifying I/O device repairs and engineering changes 

• Checking I/O devices. 



Note: Not applicable to the . 
Models 115 and 125 using 
a supervisor that does 
not support the RMSR 
function. 



Some features: 




• 


Multiple device testing 




• 


Data security 




• 


Data protection 




• 


No re-IPL time required 




• 


Prompting 




• 


ASCII data conversion 




• 


Accessing of error recording 


information 


• 


CDS Equate function. 





OLT 



OLTEP 



Printer 



OPERATOR 



Supervisor 



Card 
Read/Punch 




\K 



Teleprocessing 




OLTEP-System Relationship 
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Description and Operation OLTEP 

OLTEP operates much like other problem programs in DOS/VS. It is cataloged into 
the core image library and called by standard job control statements. When OLTEP 
is called, it notifies the operator that it is active and it communicates with him 
during testing. OLTEP can run in a batch-only system or as a background program 
in a multiprogramming environment. OLTEP must be run in the background 
partition in real mode and requires at least 14K. 

You can test an I/O unit with minimum interference to other programs running 
on the system. Testing an I/O device ordinarily does not interfere with system 
input and output. Any unit being tested (except for direct access devices) must not 
be assigned to the foreground partitions. Direct access devices, however, may be 
shared. 

An OLTEP user language defines and controls the test. With this language, you 
select the devices to test, the test sections to run, and the options to exercise. You 
enter this information via the console device or in the form of a control statement 
in the job input stream. This information is referred to as the test -run definition, 
which is common to OLTEP components for all operating systems. 

You can test multiple devices of the same type with no operator interventions 
other than those required for data protection and data security. OLTEP loads and 
executes the test sections one at a time until all the tests for one device are 
completed. If requested, the test sections then repeat for the next available device. 
Testing continues in this manner until all units in the test-run definition are tested. 

During testing under control of OLTEP, the system error recovery procedures are 
bypassed for the device being tested. OLTEP has built-in data integrity safeguards 
so that no data is destroyed without operator permission, and no protected data 
is accessed during testing. 
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Intentionally Blank 
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SECTION 3 



DEBUGGING FOR THE 
OPERATOR 



3.1 



Section 3 

/DEBUGGING 
PROCEDURES 
FOR OPERATORS 



How to Use 

This section is in the form of flowcharts that help the operator in the initial 
isolation of and possible recovery from errors that occur during system operation. 

• Each flowchart deals with a specific type of malfunction. 

• Pointers to operator's flowcharts in Section 2 (that must be followed to 
complete a procedure in this section) are referenced by the page tabs 
used in Section 2. 

For example: 



Execute a stand 
alone dump 
A-3-F 



Key to references: 



X-X-F 



Page tab 
of Section 2 

Flowchart 



• When immediate recovery is not possible, offline program debugging is 
indicated. 



Operator's Flowcharts 

Error during IPL 
Initial system checks 
System in WAIT STATE 
Unintended LOOP 
Obviously incorrect output 
Job canceled by system 



Chart 01, parts 1 through 9 3.5 

Chart 02 3.15 

Chart 03, parts 1 through 4 3.16 

Chart 04, parts 1 through 6 3.20 

Chart 05 3.26 

Chart 06 3.27 



3.2 Debugging for Operators. 



Section 3 

WAIT STATE CODES 



BYTEO 


BYTE 1 


BYTE 2 


BYTE 3* 


EXPLANATION 


IPL Error Messages placed in Low Address Storage 


X'FO' 


X'C9' 


X'FO' 


X'FO' 


This code indicates that less than 16K of real storage is left for problem programs. Check 
that the correct disk volume is mounted on the device assigned to SYSRES, and re-IPL. 
If the error recurs, the system programmer must check the allocations of real partitions 
specified in the supervisor to be used, and check that at least 16K of real storage is 
available for execution of problem programs running in virtual mode. 


X'FO' 


X'C9' 


X'FO' 


X'FV 


If a card reader has been assigned to SYSRDR during system generation and is to be the IPL 
communication device, press the INTERRUPT key. 

If a card reader has not been assigned to SYSRDR during system generation and yet it is 
to be the IPL communication device, simply READY the reader. 


X'FO' 


X'C9' 


X'FO' 


X'F2' 


This code means that the supervisor requested cannot be found. 

Check that the correct disk volume is mounted on the device assigned to SYSRES. If it is 
correct, re-IPL and specify a different supervisor when message 0I03A is issued and press the 
END/ENTER key, or press END/ENTER key only, to load the standard supervisor. (If 
possible contact the system programmer and check which supervisor to use.) 


X'FO' 


X'C9' 


X'FT 
X'F2' 


X'FO' 
X'F8' 


Refer to messages 01 1 00A - 01 28A in DOSA/S Messages. 


iMCH/CCH/IPL Hard Wait Codes placed in low address storage 


X'C1* 
X'C2' 
X'C3' 
X'C4' 
X'C5' 
X'C6' 

X'C7' 
X'C8' 
X'C9' 
X'D1' 
X'07' 


X'E2'(2) 
X'E2'(2) 
X'E2'(2) 
X*E2'(2) 
X'E2'(2) 
X'E2'(2) 

X'E2'(2) 
X*E2'(2) 
X'E2'(2) 
X'E2'(2) 
X'E6' 


A, I.Sd) 
Not used 
A, I.Sd) 
A, I.Sd) 
A, I.Sd) 
A, I.Sd) 

A, I.Sd) 
A, I.Sd) 
A. I,S(1) 
A, I.Sd) 
Channel 


Not used 
Not used 
Not used 
Not used 
Not used 
Not used 

Not used 
Not used 
Not used 
Not used 
Unit or 
X'OO' 


Irrecoverable machine check. 

Irrecoverable channel failure during RMS fetch. 

Channel failure on SYSLOG when RMS message scheduled. 

No ECSW stored. 

Channel failure: ERPBs exhausted. 

Channel failure; two channels damaged or a damaged channel situation occurred while RMS 

was executing an I/O operation. 

Channel failure; system reset was presented by a channel. 

Channel failure; system codes in ECSW are invalid. 

Channel failure; channel address invalid. 

Irrecoverable channel failure on SYSVIS. 

IPL I/O error or equipment malfunction; condition code 2 during STIDC instruction. 

Channel and unit indicate whether device in error is SYSRES or communication device. 

When byte 3 = X'OO', byte 2 indicates the channel for which STIDC instruction was 

issued. Re-IPL system. 



Notes: 1. A (X'CV) = SYSREC recording unsuccessful. 
I (X'C9') = SYSREC recording incomplete. 
S (X'E2') = SYSREC recording successful. 

2. S (X'ET) = Run SEREP. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of the wait PSW. 

Table 3-1. WAIT STATE coded messages, part 1 of 2. 
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Section 3 

WAIT STATE CODES 



BYTEO 


BYTE 1 


BYTE 2 


BYTE 3 




SDAID Hard Wait Code 


X'61' 


X'E6'(3) 


Channel 


Unit 


Another device is running in burst mode on same channel as SDAID output device. 
Re- 1 PL system. 


SDAID Soft Wait Code 


X'62' 


X'C5' 


Not used 


Not used 


SDAID output device became unready, Make printer ready and press the EXTERNAL 
INTERRUPT key. 


X'OO' 


X'OO' (3) 


X'OO' 


X'OO' 


SDAID Stop on Event. Press EXTERNAL INTERRUPT key to 
continue operations. 


The folk 


jwing Har 


d Wait Cod 


es are placed in general register 1 1 X'B' as well as in low address storage. 


X'OO' 


X'OO' 


X'OF' 


X'FF' 


Program Check in Supervisor. 


X'OO' 


X'OO' 


X'OF' 


X'FE' 


I/O error during fetch from System CIL. 


X'OO' 


X'OO' 


X'OF' 


X'FD' 


■Channel Failure if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FC 


Machine Check if MCH=NO and RMS=NO is specified during system generation. 
(Models 115and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FB' 


Page Fault in Supervisor routine with identifier RID X'OO'. 


X'OO' 


X'OO' 


X'OF' 


X'FA' 


Translation Specification Exception 


X'OO' 


X'OO' 


X'OF' 


X'F9' 


Error on Paging I/O. 


X'OO' 


X'OO' 


X'OF' 


X'F8' 


CRT phase not found. 


X'OO* 


X'OO' 


X'OF' 


X'F7* 


No copy blocks available for BTAM appendage I/O request. 


X'OO' 


X'OO' 


X'OF' 


X'F6\ 


$MAINDR canceled during system CIL update. If this occurs, the system CIL is only 
partially updated and must be restored before use. This hard wait condition can also occur 
if the FETCH QUEUE BIT (FCHQ) is set in the linkage control byte in the partition 
communication region owned by the terminating partition. 


Device E 


rror Reco 


very Wait C 


odes place 


d in low address storage. 


X'08' to 


X'd'or 


Channel 


Unit 


Error recovery messages. Refer to OP messages in DOS/VS Messages. 



Notes: 1. A (X'CV) = SYSREC recording unsuccessful. 
I (X'C9') = SYSREC recording incomplete. 
S (X'E2') = SYSREC recording successful. 

2. S (X'E2') ** Run SERE P. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of the wait PSW. 

Table 3-1. WAIT STATE coded messages, part 2 of 2. 
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Start 



Error during IPL 

CHART 01, PART 1 



Ensure that you have set the correct 
address for the device to be used as 
SYSRES, and check that the correct 
SYSRES pack is mounted. 



Ensure the word TEST is not diplayed 
or the TEST indicator is not 'ON'. 
If it is, establish the reason through 
your shift manager or IBM CE. 




System CHECK indicators 
are explained in the 
OPERATING PROCEDURES 
| manual for your Model of System/370 



Yes 



c 



Inform IBM 
immediately 



D 



Which of the following did you do after LOAD? 



Ready a 
card reader 



or 
I 



Press 
EXT INT 



Press 
REQUEST 



Supervisor required 
must be specified in 
first card read 



Supervisor 1 selected 
by default 




No 



Specify the supervisor 
required 



Hard wait message 
See Table 3-1 



Which of the following did you do next? 



Ready a 
card reader 



Press 
EXT INT 



IPL communication 
device is the card reader 
made ready 



or 

_L 



Press 
REQUEST 



IPL communication device 
is the card reader assigned 
during system generation 



IPL communication 
device is SYSLOG 




To part 5 



To part 2 
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Error during IPL 

CHART 01, PART 2 



From part 1 



01 10A GIVE IPL CONTROL COMMANDS 



For example: 

01151 PUB ALREADY EXISTS 




No 



To part 3 



Yes 



Complete operator action .> 
under appropriate message 
number in DOS/VS Messages i 



See D-1 -F For Models 1 35, 1 45, 1 1 i 
and D-2-F for Models 1 1 5, 1 25 
and D-3-F for Model 158 



Coded messages stored in bytes | 
0-3 of low address storage are 
listed in Table 3-1 on page 3.3. "\ 



Dump, or display and note the 

• Current PSW 

• 16 Control registers 

• 16 general registers 

• Low address storage 




Yes 



^Complete operator/programmer \ 
[action. See Table 3-1 . J 



To part 8 



3.6 Debugging for Operators. 



Error during IPL 
CHART 01, PART 3 



From part 2 




Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



See D-1-F for Models 135, 145, 155-11 
and D-2-F for Models 1 15, 125 
and D-3-F for Model 1 58 



Coded messages stored in bytes 
0-3 of low address storage are 
listed in Table 3-1 on page 3.3 



0I20I DOS/VS IPL COMPLETE 




Yes 



Complete operator/programmer \ 
action. See Table 3-1 on page 



:3.3y 



Yes 



Proceed with normal job 
processing 



Put SYSRES on a different drive, 

and if possible, select a different 

channel. 

(Do not forget to set the new 

address for SYSRES.) 



Re-IPL 




To part 4 



Debugging for Operators. 



3.7 



Error during IPL 
CHART 01, PART 4 



From part 3 



0I20I DOS/VS IPL COMPLETE 




Yes 



No 



Use the reserve (backup) 
SYSRES pack 



Re-IPL 



0I20I DOS/VS IPL COMPLETE 




Yes 



Is it the first IPL for 
a newly assembled 
supervisor? 



Save notes about your 

problem and actions, 

and inform your shift manager. 



No 




Proceed with normal 
job processing 



Yes 



See D-1-F for Models 135, 145, 155-111 
and D-2-F for Models 1 1 5, 1 25 
and D-3-F for Model 1 58 



No 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



Save the notes about your 
problem and actions, and 
inform your system programmer. 



Execute a stand- 
alone dump. 
A-3-F. 



For programmer action 
see section 4 (Chart 01 ) 



Save the hard copy of 
SYSLOG output and the 
stand-alone dump for IBM 



Inform IBM of 
your problem 
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Error during IPL 
CHART 01, PART 5 



From part 1 




No 



See D-1-F for Models 135, 145, 155-11 
and D-2-F for Models 1 1 5, 1 25 
and D-3-F for Model 1 58 



The first character of a message 
originated by IPL is a 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 




To part 6 




Yes 



Put SYSRES on a different drive, and if 
possible, select a different channel. 
(Do not forget to set the new 
address for SYSRES.) 



Complete operator action under 
appropriate message number in 
DOS/VS Messages 



01201 DOS/VS IPL COMPLETE 




Yes 



See D-1-F for Models 135, 145, 1 55-1 1 1 
and D-2-F for Models 1 1 5, 1 25 j 

and D-3-F for Model 1 58 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 1 6 general registers 

• Low address storage 



Proceed with normal job 
processing 



\y 



To part 8 
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Error during IPL 
CHART 01, PART 6 



From part 5 



See D-1-F for Models 135, 145, 155-11 
and D-2-F for Models 1 15, 125 
and D-3-F for Model 158 

Coded messages stored in bytes 
0-3 of low address storage are 
listed in Table 3-1 on page 3.3 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



0I20I DOS/VS IPL COMPLETE 




Yes 



Complete operator action 
under appropriate message 
number in DOS/VS Messages . 



Yes 



Put SYSRES on a different drive, 

and if possible, select a different 

channel. 

(Do not forget to set the new 

address for SYSRES.) 



( Proceed with normal processing J 



Re-IPL 



0I20I DOS/VS IPL COMPLETE 




Yes 



Use the reserve (backup) 
SYSRES pack 



Save notes about your problem 
and actions, and inform your 
«hift manager 



Re-IPL 




I Proceed with normal (processing J 



To part 7 
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01201 DOS/VS IPL COMPLETE 



01201 DOS/VS IPL COMPLETE 



Is it the first IPL for 
a newly assembled 
supervisor? 



From part 6 




Yes 



No 



Use new IPL control cards 



Re-IPL 




No 




No 



Execute a stand-alone 
dump. 

A-3-F. 



Save the hard copy of 
SYSLOG output and the 
stand-alone dump for IBM 



Yes 



Yes 



Inform IBM of 
your problem 



Error during IPL 

CHART 01, PART 7 



Save notes about your 
problem and actions and 
inform your shift manager 



Proceed with normal 
job processing. 



Execute a stand-alone 
dump. 

A-3-F. 



Save the notes about your 
problem and actions, and 
inform your system programmer. 



For programmer action 
see Section 4 (Chart 01 ) 
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Error during IPL 
CHART 01, PART 8 



From part 2 




Yes 



Proceed with normal 
job processing 



From part 5 




Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 1 6 general registers 

• Low address storage 



iSee D-1-F for Models 135, 145, 155-11 
|and D-2-F for Models 115, 125 
land D-3-F for Model 158 



gf Coded messages stored in bytes 
„' 0-3 of low address storage are 
/ listed in Table 3-1 on page 3.3 




Yes 



No 



Execute a stand- 
alone dump. 
A-3-F 



If possible, use a different 
device as IPL communication 
device. 



Use reserve SYSRES pack, 
and if communication 
device is SYSRDR, use a 
new IPL control card deck. 



Re-IPL 




Re- IPL 



Yes 



Re-IPL 



No 




To part 9 





To part 9 
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Error during IPL 
CHART 01, PART 9 



From part 8 



From part 8 




0I20I DOS/VS IPL COMPLETE 




Yes 



No 




Proceed with normal 
job processing 



Execute a stand 
alone dump. 
A-3-F 



Inform your shift 
manager of your 
problem 



No 




Is it the first I PL for 
a newly assembled 
supervisor? 



Yes 



Execute SE REP 
(Refer to F-4-F for 
Models 135, 145, and 
155-11) or 
Display log analysis 
(Refer to F-5-for the 
Models 115 and 125 or 
F-6 for the Model 158) 



Save the low address 
storage dump, the stand- 
alone dump, and the 
SEREP printout for IBM. 



Save the notes about 
your problem and 
actions, and inform your 
system programmer. 



Rebuild SYSRES. 

Save the original SYSRES. 

Save the low address 

storage dump. 

Save the stand-alone dump, 

Inform IBM of your 

problem. 



Inform IBM of 
your problem 



For programmer action 
see Section 4 (chart 01 ) 



Proceed with normal 
job processing 



Debugging for Operators. 3. 1 3 



Initial System Checks 

NOTES FOR CHART 02 



Note 1 < 



r 



Note 2 < 



\ 



Recognizing a wait state 

Any of the following observations confirm that the system is in a Wait State: 

• WAIT indicator remains on, or on the Models 1 15 and 125 the word WAIT 
remains displayed on the video display unit. 

• SYS indicator remains off (Not applicable to the Models 1 15 and 125). 

• No I/O device activity occurs. 

• One or more SYSTEM CHECK indicators on. 

• A HARD MA CHINE CHECK message is issued on SYSL OG or a 
coded "wait state" message may be contained in bytes 0-3 of 
low address storage or in GR II (X'B') 

Recognizing a loop 

One or more of the following occurrences may indicate that a job /program is in 
an unintended loop: 

• A steady glow in the light of the system control panel with the SYS indicator 
on. For the Models 1 15 and 125, the word WAIT may flicker on the video 
display unit. (This depends on the size and nature of the loop.) 

• A rhythmic pattern in the lights of the system control panel, or, for the 
Models 1 15 and 125, the word WAIT may flicker on the video display unit 

• A pointless recurrence of I/O activity. 

• A job /program that does not change status for a long time. This may result, 
for example, in an absence of I/O activity with both SYS and WAIT 
indicators on. 

A note to the operator: When a loop is recognized, first try to contact the 
programmer before beginning any debugging procedures. If this is not possible, 
follow the instructions in chart 04. 



Note 3 < 



V 



Recognizing incorrect output 

Incorrect output during system operation may be recognized by any one of 
the following: 

A. Duplicate output 

Output of identical data or more output than expected on: 

• line printer 

• console printer 

• card punch 

• video display unit. 

B. Invalid or unidentified output 

Printed (or displayed) output that is obviously incorrect on: 

• line printer 

• console printer 

• video display unit. 

C. Lack of output 

No output when there should be,or less output than expected on: 

• line printer 

• console printer 

• card punch 

• video display unit. 



f Job/program canceled by system 

The system's canceling of job is normally caused by a Program Check Interrupt 
that is recognized by a message, for example: 

BG 0S031 PROGRAM CHECK INTERRUPTION - HEX LOCATION 0610F8 
Note 4 <( CONDITION CODE 2 - SPECIFICATION EXCEPTION 

0S001 JOB NO NAME CANCELED 

The program is automatically canceled by the supervisor and depending on the 
use of the job control statement, //OPTION DUMP, a dump of the partition 
and supervisor is executed. 
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- Check 1 

Message on 
SYS LOG 



- Check 2 

Output from 
job/program 
(See note 3) 



Initial System Checks 

CHART 02 



Did you understand the message and respond to 

it correctly? If no message was printed, go to check 2. 



Yes 



Save SYS LOG 
output, and go to 
check 2. 



No 



Contact your shift manager 
before rerunning or restarting 
the job/program 



Is there unscheduled output? 

Is scheduled output not as expected? 



Yes 



No 



Save the output, 
and go to, check 3 



Make a note, and 
go to check 3. 



- Check 3 

Input/output 
devices. 



- Check 4 

Input/output 
media 



- Check 5 - 

Program change 
during run 



- Check 6 

Programmer's 
instructions 



Are the assigned devices set up correctly? (e.g. bits per inch) 



No 



Rerun or restart 
job/program. 



N 



Have any of the assigned devices a malfunction 
condition? (Some examples of device malfunctions 
are listed in Section 1.) 



Yes 



Try to use a different 
device or consult the 
operating guide for the 
device, and inform your 
IBM customer engineer. 



No 



Go to check 4. 



Are you using correct SYSRES pack? 

input files/volumes? 
work files/volumes? 
Input/output devices? 
teleprocessing lines? 



No 



Yes 



Contact your shift manager 
before rerunning or restarting 
the job/program 



Go to check 5. 



Have you altered the contents of any real or 
virtual address area since the job/program began 
running? 



Yes 



No 



Compare your notes 
of the alterations 
with the programmer's 
instructions. If there 
is a difference, try to 
contact the programmer 
before rerunning the job. 



Go to check 6. 



Do you understand the programmer's 

instructions? 

(If in doubt, try to contact the programmer.) 



No 



Yes 



Contact your shift manager 
before rerunning or restarting 
the job/program 



Go to check 7. 



- Check 7 

Operating 
procedures 



Are there any recent changes in the system 
operating procedures, and if so, do they affect 
this job? 

(If in doubt, contact your shift manager or 
senior operator.) 



Yes 



No 



Contact your shift manager 
before rerunning or restarting 
the job/program 



Go to check 8. 



- Check 8 

Categorize the 
malfunction 




System in a WAIT STATE? (See note 1 ) 
LOOP? (See note 2) 

Obviously incorrect output? (See note 3) 
Job/program canceled by system? (See note 4) 



Turn to chart 03 
Turn to chart 04 
Turn to chart 05 
Turn to chart 06 
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Wait State 
CHART 03, PART 1 



h a- a 

Model-dependent ="~~~==3^Sp==l 
control console vS)®@®@®® 
layout HB B 0MS8 EJ 




SYS MAN WAIT TEST LOA0 

ooooo 






Start 



WAIT indicator ON 
SYS indicator OFF 



Yes 



t 




The TEST indicator is on when any of the following 
switches are not in the process or normal position. 

1. RATE 

2. CHECK CONTROL 

3. DIAGNOSTIC/CONSOLE FILE CONTROL 

4. ADDRESS COMPARE CONTROL 



No 



Yes 



i 



The MANUAL indicator is on when the CPU clock is 
stopped or the system is in a soft-stop state. All pending 
interrupts are handled. Manual store/display operations 
are possible only when the MANUAL indicator is on. 



Yes 



I 



If SYSLOG is inoperative, a device error recovery message 
may have been printed on the line printer assigned as 
SYSLST. 

Example of a device error recovery message 



0P08A INTERV REQSYSRDR=00C 




Inform your shift leader or 
manager of the condition, 
and request time for 
hands-on debugging to 
gather system information. 



Consult DOS/VS 
Messages manual 



To part 2 of this chart 
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From part 1 of this chart 



Wait State 
CHART 03, PART 2 




AR 1I60A READY FOR COMMUNICATIONS. 



Yes 



Yes 



See D-4-F for Models 135, 145, 155-1 1 
and D-5-F for Models 1 1 5, 1 25 
and D-6-F for Model 158 



Check that the last JCL 
assigning SYSLOG was a 
statement and not a 
command 



No 



No 



Dump or display low 
address storage. Use 
ALTER /DISPLAY 



Compare the contents of 
bytes 0-3 of low address 
storage with the list of 
wait state coded messages 
shown in table 3.1 on 
page 3.2 




Yes 




Yes 



Yes 



No 



Continued debugging using 
the flowchart shown in 
Section 2,E-3-F. 



SOFT WAIT 



To part 4 of this chart 



D 



To part 3 of this chart 
Debugging for Operators. 
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Wait State 

CHART 03, PART 3 



From part 2 of this chart 



Issue the MAP command. 
Refer to Section 2, E-1. 



Make each I/O device 
NOT READY, then 
READY in turn, checking 
for any l/Q activity as 
this action is carried out. 



No 




Yes 




No 



Yes 



Contact terminal (s) and 
request data to be 
entered 



Yes 




If an interrupt occurs, the CPU 
is taken out of the wait state ,| and 
•processing is started under control 
of the program being executed. 



No 



To part 4 of this chart 
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Wait State 
CHART 03, PART 4 



From part 2 of this chart 



Execute a stand 
alone dump 
A-3-F 



Execute SEREP (Refer to 
F-4-F for Models 135, 145, 
and 155-11) or Display log 
analysis (Refer to F-5 for 
the Models 1 1 5 and 1 25 or 
F-6forthe Model 158) 



RE-IPL 



If the problem recurs, re-IPL 
and execute EREP (select 
default options) F - 3 - F 



Have the SEREP, EREP 
and stand-alone dump out- 
puts available for your IBM 
customer engineer 



HARDWARE ERROR 

Note: Certain unusual hardware and software failures can 
cause the system to halt processing with both the system 
light and the wait light on continuously. This indicates that 
the current PSW has its wait bit set on but the CPU is 
processing microprogram instructions. If possible, the 
system should be left in this state until a customer engineer 
has arrived. A stand-alone dump can show the I/O 
operations in process. 



From part 2 and 3 
of this chart. 




Execute a stand-alone dump 
as recommended in Section 2, 
A-3-F. On completion of the 
dump, re-iPL and obtain a 
dump or copy of the page data 
set as described in Section 2, C-6 




No 



Dump the 
POWERQFILE 
(Use a disk to 
printer program) 



Save the following system 
information for the 
programmer: 

• SYSLOG output 

• Line printer output, including 
the stand-alone dump output, 
the dump or copy of the 
page data set, and the POWER 
QFILE dump (if applicable) 

• Job stream 

• Note of the current PSW 

• Note of your actions 

• Input files/volumes 



OPERATIONAL 

OR 

PROGRAMMING ERROR 
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Unintended Loop 

CHART 04, PART 1 



Start 



Inform your shift leader or 
manager of the malfunction 
and request time for hands-on 
debugging to gather system 
information. If possible, 
check estimated job run 
times with the programmer (s) 



From part 5 of this chart 



r 



Press REQUEST 



Determine if 
loop is in -^ 

supervisor 



V. 



Yes 



Are any 

partitions using 

^teleprocessing input /^ 

sPutput methods^ 



No 



Yes 





AR 1I60A READY FOR COMMUNICATIONS 



NO 



Loop is probably 
in the supervisor. 



A program or partition is time dependent when it uses 
one or any of the following I/O methods: MICR 
(Magnetic Ink Character Recognition), OCR 
(Optical Character Recognition), TP (Telepro- 
cessing) 



No 



No 



Yes 



TP suspected of causing loop 




MICR and/or OCR 
suspected of causing loop. 






3.20 



To part 2 of this chart. 
Debugging for Operators. 



To part 3 of this chart. 



To part 4 of this chart. 



To part 4 of this chart. 



Actions to prevent the 
following procedures -^ 
affecting MICR/OCR. 



From part 1 of this chart. 



Unintended Loop 

CHART 04, PART 2 



r 




No 



Empty the hopper of the 
MICR and OCR devices 



V 



If the message 
INTERN/ REQ is issued on 
SYS LOG for the MICR 
and/or OCR devices, DO 
NOTREADY these devices 



If possible consult your 
shift leader or manager 
before making this 
decision. 




No 



Execute the MAP 
command; refer to Section 
2, E-1. 




To part 5 of this chart. 



No 



For system programmers and IBM CE/SEs only. 



If possible assign SYSLST to a line printer on the 
partition being used to initiate SDAIDS. If a line 
printer is not available assign SYSLST to a tape 
unit or disk drive. (In the last case disk label 
information must be supplied.) 

Initiate SDAID BR trace between limits of partition 
owning failing program. Refer to B-10-F. (Partition 
limits can be obtained from the MAP output.) 

In conjunction with the assembly listing of the 
failing program you may be able to localize the 
error by scanning the SDAID output. 

You can further localize the error by adding IF, 
SA, and GA trace routines via CR 9 and reducing 
the event limits via CR 10 and 1 1 . 




No 



To part 6 of this chart. 



H 
To part 6 of this chart. 
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Unintended Loop 



CHART 04, PART 3 

From part 1 of this chart 




Inform terminal (s) of 
malfunction condition 




No 



Yes 




No 



Yes 



No 



Partition using TP 
is causing loop 



No 




No 



Yes 



TP is causing loop 



Loop is in partition using TP 




Yes 




Yes 



Partition using TP 
is not causing loop 



Inform terminal (s) that there will be TIME-OUT and that program using TP 
may have to be restarted or re-run at some otheif time, because of 
hands-on debugging procedures 



No 



No Loop; continue 
processing 



To part 4 of this chart 



To part 2 of this chart 



To part 4 of this 
chart 
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Unintended Loop 

CHART 04, PART 4 



From part 1 of this chart 



Press STOP on all 
M I CR /OCR devices 



Message 
INTERVREQ 
issued for MICR 
JDCR devices. 



Yes 



No 



From part 1 , or part 3 
of this chart. 



Loop involves operation 
on MICR/OCR 



D 



Trace loop by instruction 
step method. 



|See D-4-F for Models 135, 145, 155-11 
and D-5-F for Models 115, 125 
land D-6-F for Model 158 

Note: 

It is important that at least 
15-20 instructions in the 
loop are noted. A trace of 
complete loop depends on 
time allowed for debugging. 



To part 6 of this chart 
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Unintended Loop 

CHART 04, PART 5 



From part 2 of this chart 



r 



Pause all jobs to 
free a partition. 




Press REQUEST 



"< 



^ 



An EOJ is indicated by the SYS LOG message 

XX READY FOR COMMUNICATIONS 

(XX indicates the partition issuing the message). 



When Attention Routine 
is initiated (AR issued 
on SYSLOG), enter 
PAUSE BG, EOJ 
PAUSE F4, EOJ etc, to 
pause all partitions. 




No 



Yes 



Execute the MAP 
command; refer to Section 
2, E-1. 



Before proceeding, check 
estimated job run time, either 
by contacting the programmer 
or from program run sheet 




To part 1 of this chart 




No 



Yes 



For system programmers and IBM CE/SEs only. 

If possible assign SYSLST to a line printer on the 
partition being used to initiate SDAIDS. If a line 
printer is not available assign SYSLST to a tape 
unit or disk drive. (In the last case disk label 
information must be supplied.) 

Initiate SDAID BR trace between limits of partition 
owning failing program. Refer to B-10-F. (Partition 
limits can be obtained from the MAP output.) 

In conjunction with the assembly listing of the 
failing program you may be able to localize the 
error by scanning the SDAID output. 

You can further localize the error by adding IF, 
SA, and GA trace routines via CR 9 and reducing 
the event I imits via CR 1 and 1 1 . 




To part 6 of this chart 
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Unintended Loop 

CHART 04, PART 6 



From part 5 of this chart. 



At this stage, if only one job has not reached 
EOJ, it is possible that this job is causing the 
loop. Check estimated job run time with 
programmer or on program run sheet 




Yes 



From part 2 of this chart 



No 



More than one job still 
running 



Loop is probably caused 
by this job 




Trace loop either by 
instruction step (See 
note 1 ) or by using SDAID 
routines B-10-F (See 
note 2) 



Let system continue 
processing. Programmer 
must immediately 
analyze the problem 



Yes 



From part 4 of this chart 



Execute a stand-alone dump 
as recommended in Section 2, 
A-3-F. On completion of the 
dump, re-IPL and obtain a dump 
or copy of the page data set as 
described in Section 2, C-6. 



Turn to Section 4, 
Chart 01, Part 2 



Save the following for the 
programmer: 

• SYSLOG output 

• Line printer output 

• Job stream 

• I/O files/volumes 

• Loop trace (instruction 
step or SDAID output) 

• MAP, if applicable. 



Note 1: 

See D-4-F for Models 135, 145, 155-11 
and D-5-F for Models 1 15, 125 
and D-6-F for Model 158 

Note 2: 

SDAID should be used 
only by system programmers 
or by IBM CB/SE. 



Re-IPL: initiate 
different jobs 
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Obviously Incorrect Output 
CHART 05 



Start 



The identity of the partition using the device: 

This can be deduced from information given on 

the job run sheet, or the device ASSGN statements 

and commands issued on SYSLOG and SYSLST. 

An alternative method is to make the device producing 

incorrect output NOT READY. This will cause a 

device error recovery message to be issued on SYSLOG. 

Determine the partition using the device from the 
message printed on SYSLOG as a result of this action. 



BG 0P08A INTERV REQSYS008= 383 



Partition identity 



I/O Device Address 



If SYSLST for the partition to be dumped is not 
assigned to a line printer, use the line printer 
assigned as SYSLST on another partition. 
For example, DUMP F2S(BG). 
Note: This may produce dump output from the 
partition being dumped, interspersed with 
output from the program using the line printer. 



A System dump may be issued on the device assigned to 

SYSLST for the partition being canceled. 

(The System dump is described in Section 2, A-2.)' 













H possible, contact the programmer 
to establish the expected output, 
and identify which job or partition 
is using the device that is 
producing the incorrect output 














Make the device producing 
incorrect output NOT READY 














Press REQUEST and wait for 
message 0P60D, then enter 
IGNORE 












AR 1I60A READY FOR COMMUNICATIONS. 












Respond to the AR message 

by issuing the DUMP command 

to dump the partition and the 

supervisor, for example, DUMP F2S 

SYSLST must be assigned to a 

line printer. 

Refer to Section 2, A-1 














Cancel the job in the partition 
producing the incorrect output 














Save the following information 
for the programmer(s). 

• SYSLOG output 

• Line printer output, including 
all dump output 

• Job stream 

• I/O files/volumes 
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Program Canceled 

CHART 06 



Start 



An informative message 
is issued on SYS LOG 
orSYSLST,orboth 



0P731 JOB DEBUGEX8 CANCELED DUE TO I/O ERROR 
0S071 PROBLEM PROGRAM PSW 031 0000000007 A02 



An example of a job cancellation 
message issued on SYSLST 



BG 0P24I C PROG CHECK SYS009=00D 

CCSW=001 000022800200000 CCB=007A0E 

SNS=0000000000000000000000000000000000000000000000001 
BG 0P73IJOB DEBUGEX8 CANCELED DUE TO I/O ERROR 



An example of a job cancellation 
message issued on SYS LOG 



A system dump is issued 
to the device assigned as 
SYSLST 



A system dump is issued to SYSLST under the 
following conditions 

1. The supervisor in use supports the OPTION DUMP, 
which is not overruled by the job control statement 
// OPTION NODUMP in the job stream. 

2. The job control statement // OPTION DUMP is 
included in the job stream. 

For a complete description of the system dump, refer 
to Section 2, A - 2. 




No 



Yes 



Dump the disk extent, or 
tape assigned as SYSLST 
to obtain a printed dump 



Execute to 
MAP command 
E-1 



Save the following information 
for the programmer: 

• SYSLOG output 

• Line printer output, including 
any error messages and the 
system dump 

• Job stream 
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For your notes 



3.28 Debugging for Operators. 



DOS/VS Serviceability Aids and Debugging Procedures 

SECTION 4 



DEBUGGING FOR 
SYSTEM PROGRAMMERS 



Section 4, DOS/VS Serviceability Aids and Debugging Procedures 

DEBUGGING 

PROCEDURES 

FOR SYSTEM 

PROGRAMMERS How to use 



The choice of serviceability aids and methods of off-line program debugging and of 
analyzing each programming error rests with the programmer. The flowcharts in 
this section, however, will help the programmer to choose the method best suited to 
the type of error. For efficient analysis of dumps, program output, and printouts, 
an understanding of DOS/VS information blocks and supervisor interface tables is 
required. This section describes how your programs, referred to as user programs, 
interface with the IBM System Control Programs (SCPs). It also illustrates the 
allocations of storage, program and supervisor save areas, and details the informa- 
tion contained in the interface tables useful for program debugging. 

The debugging of user programs written in a high-level language or for use with 
teleprocessing are not discussed. However, the serviceability aids described in 
Section 2 and the operator procedures of Section 3 should be used initially to 
gather information from the system. Having obtained the information, the procedures 
in this Section can then be used inconjunction with the debugging procedures 
described in the applicable high level language or teleprocessing component manuals. 

This Section is divided into two parts. The first part consists of checklists in the 
form of flowcharts that should be used as a guide during offline program debugging. 
They help in selecting a method of analysis, and if required, help in the choice of 
the serviceability aid for further error isolation. 

The second part of this section consists of a general description of the DOS/VS 
supervisor tables, information blocks, and save areas, together with other system 
information useful for offline debugging. More details about these tables and areas 
can be found in the IBM publication DOS/VS Supervisor Logic. 

Note: It is assumed that the programmer using this section is familiar with DOS/VS 
multiprogramming, asynchronous processing (multitasking), relocating load, virtual 
storage, and data management techniques. These techniques are described in the 
DOS/VS System Management Guide. 



Debugging for Programmers 



Section 4, Part 1 

CONTENTS 



Flowcharts for offline debugging 

1. Initial checks on the program and its input 4.2 

2. Programming errors that generate problems during IPL 4.5 

Isolating errors that cause the system to enter a WAIT STA TE. 

3. HARD WAIT STATE with a coded message in low address storage ; 4.7 

4. HARD WAIT STATE with no coded message in low address storage 4.8 

5. SOFT WAIT STATE 4.9 

6. Isolating errors that generate unintended program loops 4.1 1 

7. Isolating errors that produce incorrect output that is detected after an 

indefinite time since execution of the program 4.12 

8. Isolating errors that produce incorrect output that is detected either during, 

or immediately after execution of the program 

Isolating errors that cause program/ job cancellation: 

9. Because of a PROGRAM CHECK in a user written program 4.19 

10. Because of an ILLEGAL SVC 4.25 

1 1. For other reasons 4.26 

12. Because of a PROGRAM CHECK within the supervisor area 4.27 

13. Because of a PROGRAM CHECK within the partition owning POWER 4.30 
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Initial Checks 

CHART 01, PART 1 OF 2 



Start 



Program Error 
recognized by: 



Operator 
not able 
to IPL 



Operator during 
execution of 
job/program 



Error during IPL 



System entered 
a wait state 



Incorrect output 
detected at some 
time after running 
the job/program 



Turn to chart 07 
in this Section 



Unintended loop 
developed 



Program produced 
obviously incorrect 
output 



Job/program 
canceled 



The operator should supply this data gathered from the system when the error occurred 



SYSLOG output. 
Dump, or note of 
low address storage 
bytes X'OO'-X'BF' 
Stand-alone dump. 
SYSRESpack in use 
when error occurred. 



SYSLOG output. 
Dump, or note of low 
address storage & current 
PSW. 

Stand-alone dump. 
Dump or copy of SYSVIS. 
Any line printer output 
when error occured. 
Job stream. 

Note of Input/output files/ 
vols. SEREP/EREP output 
if applicable to cause 



SYSLOG output 

Partition dumps, if any 

taken. 

MAP of system. 

Job stream. 

Any line printer output 

when error occurred. 

Stand-alone dump. 

Dump or copy of SYSVIS 

Loop trace, either 

manual or SDAID. 



SYSLOG output 
Line printer output, 
including the dump 
of the partition using 
the device producing 
incorrect output. 
A dump of the 
supervisor, or a 
System dump. 
Job stream. 
All input/output files/ 
vols used by the 
partition dumped. 



SYSLOG output 
System dump (if 
executed). 
Any line printer 
output from Job, 
including any 
messages. 
Job stream. 



1 he application programmer should supply you with this data to aid problem analysis 



As the system programmer 

you may require: 
Supervisor listing 
of supervisor in use. 
Linkage editor map 
for the supervisor 
in use when error 
occurred. 



Program listings of 
all programs being 
executed when error 
occurred. 

Linkage editor maps 
for the programs. 
Supervisor listing for 
supervisor in use. 



Program listing of the 
program in which 
loop developed. 
(If loop was not 
isolated to a partition, 
program listings of all 
programs being 
executed when loop 
occurred may be 
required.) 
Linkage editor map 
for program(s). 



Program listings. 
Linkage editor map. 



As the system programmer 
you may require: 

Program listings. 

Linkage editor map. 

Supervisor listing. 



Turn to chart 02 
in this Section 



A 



To part 2 
of this chart 



4.2 Debugging for Programmers, part 1 . 



From part 1 
of this chart 



y 



Check 1 

Error messages 



I — Check 2 — 

Program execution 



i — Check 3 — 

Program, or module 
(sub-routine) coding 



i — Check 4 

Input media 



- Check 5 — i 

Input/output 
device and type 



, — Check 6 — i 

DOS/VS level of 
release 



Check 7 

Job control 
statements 



- Check 8 - 

System hardware 
configuration 



, — Check9 - 

Categorize error 





Initial Checks 

CHART 01, PART 2 OF 2 



Look for messages on console printer log sheet, or 
line printer output associated with the job in error. 



Consult "Programmer Action" listed in 
DOS/VS Messages. If solution to 
problem not found, return to check 2. 



No 



Has the program ever run successfully? 



M 



Go to check 9 



Yes 



•/Has there been a reassembly of the program, or any 
module used by it, since the previous run? 

• Has the program or any module used by it been 
recataloged since previous run? (For example, 

a change in LOAD or ENTRY addresses.) 

• Has any coding been changed by REP or SOURCE 
cards? 

• Has an IBM programming temporary fix (PTF) 
been applied to the program, or any of its modules? 




• Has there been any change in the location of data 
on any of the input files? (For example, the area 
containing the data on a disk pack has been moved 
to another address either on the same pack, or on a 
different pack.) 

• Has there been a change in any input media? (For 
example, input data was previously on cards, but has 
since been transfered to disk pack.) 



Was a different physical input/output device type 
assigned? (For example, in the previous run, I/O 
device was a 3330 disk drive, but is now a tape unit.) 




• Did the program run previously under the same 
supervisor DOS/VS release? 

• Was the same supervisor used for both runs? 

• Have there been any changes to the supervisor, since 
the previous run? (For example, re-system generation) 



Has there been any real change in job control since 
previous run? (For example, a change in the // EXEC 
parameter to REAL from default.) 



Was the program executed on a different system 
configuration from the previous run? 
(For example, a different model of CPU.) 




•Program error recognized by: 
WAIT state 



LOOP 

Obvious incorrect output 
Job/program canceled 



Go to check 3 and continue through 
this checklist. It is recommended to make 
a copy of this chart and make notes 
(for future reference) in this column 
of any differences from previous 
execution of the program. 
At this stage there is no need for further 
action, unless the solution to the problem 
becomes obvious. 





Turn to chart 03 
Turn to chart 06 
Turn ot chart 08 
Turn to chart 09 
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Intentionally Blank 
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Errors during IPL 
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Check 



— Check 1 

Supervisor listing 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



If the IPL procedure can not be completed 
and the supervisor in use has never been used 
on the system, check the supervisor assembly 
listing for flagged statements. Also note in 
the listing the options supported by the 
supervisor. 

Check that the hardware is present in the 
system for options supported by the super- 
visor that require hardware support. 

Also check that the supervisor is generated 
to support hardware options that are present 
on the system. 



If the cause of the error can not be isolated, 
inform IBM and have the following informa- 
tion available: 

• The supervisor listing 

• The stand-alone dump output, including 
the dump of the low address storage 

• SYSVIS dump, or copy of the PDS 

• The SYSRES pack used when the error 
occurred 

• Any notes about actions taken during error 
analysis both on and offline. 
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Hard Wait Message Codes 
SUPPORT FOR CHART 03 



BYTEO 


BYTE 1 


BYTE 2 


BYTE 3 


EXPLANATION 


MCH/CCH/IPL Hard Wait Codes placed 


in low address storage 


X'CV 


X'E2'(2) 


A, l,S(1) 


Not used 


Irrecoverable machine check. 


X'C2' 


X'E2'(2) 


Not used 


Not used 


Irrecoverable channel failure during RMS fetch. 


X'C3* 


X'E2'(2) 


A, l,S(1) 


Not used 


Channel failure on SYSLOG when RMS message scheduled. 


X'C4' 


X'E2'(2) 


A, I, SO) 


Not used 


No ECSW stored 


X'C5' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure: ERPBs exhausted. 


X'C6' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; two channels damaged or a damaged channel situation occurred while RMS 
was executing an I/O operation. 


X'C7' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; system reset was presented by a channel. 


X'C8' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; system codes in ECSW are invalid. 


X'C9' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; channel address invalid. 


X'DT 


X'E2'(2) 


A, I, SO) 


Not used 


Irrecoverable channel failure on SYSVIS. 


X'07' 


X'E6' 


Channel 


Unit or 
X'OO' 


IPL I/O error or equipment malfunction; condition code 2 during STIDC instruction. 
Channel and unit indicate whether device in error is SYSRESor communication device. 
When byte 3 = X'00', byte 2 indicates the channel for which STIDC instruction was 
issued. Re-I PL system. 


SDAID Hard Wait Code 


X'61' 


X'E6'(3) 


Channel 


Unit 


Another device is running in burst mode on same channel as SDAID output device. 
Re-IPL system. ■■>«<. 


SDAID Soft Wait Code 


X'62 


X*C5' 


Not used 


Not used 


SDAID output device became unready. Make printer ready and press the EXTERNAL 
INTERRUPT key. 


X'00' 


X'00'(3) 


X'OO' 


X'OO' 


SDAID Stop on Event. Press EXTERNAL INTERRUPT key to ., 
continue operations. 


The foil 


owing Hard Wait Codes are plac 


3d in general register 1 1 X'B' as well as in low address storage. 






w.rr-. 






/\ \J\J 


•\ VI 


/\ i r 


i iuyiam v^ncCK in oupei visut . 


X'00' 


X'00' 


X'OF' 


X'FE' 


I/O error during fetch from System CI L. 


X'00' 


X'00' 


X'OF' 


X'FD' 


Channel Failure if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'00' 


X'OO* 


X'OF' 


X'FC 


Machine Check if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'00' 


X'OO' 


X'OF' 


X'FB' 


Page Fault in Supervisor routine with identifier RID X'OO.' 


X'00' 


X'OO' 


X'OF' 


X'FA' 


Translation Specification Exception 


X'00' 


X'OO' 


X'OF' 


X'F9' 


Error on Paging I/O. 


X'00' 


X'OO' 


X'OF' 


X'F8' 


CRT phase not found. 


X'00' 


X'OO' 


X'OF' 


X'F7' 


No copy blocks available for BTAM appendage I/O request 


X'00' 


X'OO' 


X'OF' 


X'F6' 


$MAINDR canceled during system CI L update. 

If this occurs, the system CIL is only partially updated and must be restored before use. 
This hard wait condition can also occur if the FETCH QUEUE BIT (FCHQ) is set in the 
linkage control byte in the partition communication region owned by the 
terminating partition. 


Device E 


rror Recovery Soft Wait Codes 


placed in low address storage. 


X'08' to 


X'd'or 


Channel 


Unit 


Error recovery messages. Refer to OP messages in DOS/VS Messages. 



Notes: J. A (X'CV) = SYSREC recording unsuccessful. 
I (X'C9') = SYSREC recording incomplete. 
S (X'E2') = SYSREC recording successful. 

2. S(X'E2')°= Run SERE P. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of the wait PSI/V. 



Refer to Section 2-E-3 for a list of IPL error message codes and a more detailed description of wait states. 
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Hard Wait with Message in Low Address Storage 
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Check 



i — Check 1 

Eliminate components 



- Check 2 - 

WAIT STATE 
occurs when 
programs run 

under DOS/VS 
without POWER 



— Check 3 — 

Analyze message in 
low address storage 



- Check 4 - 

Locate old PSW 



- Check 5 — - 
Locate failing 
instruction address 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Was the POWER or POWER RJE system 
control proqram active when the malfunction 
occured? 



Yes 



Re-run the program(s) without initiating 
POWER. (Run the same job(s) under direct 
control of DOS/VS.) When running under 
POWER RJE you will have to submit the job 
to the central station and request it to be 
run without POWER RJE. If the identical 
error occurs go to check 3. If the error does 
not occur you may suspect the POWER SCP 
of causing the error. Before calling IBM turn 
to check 14 of chart 08, part 5. 



No 



Go to check 2. 



r*- HARD WAIT STATE 



Proceed to check 3. 



SOFT WAIT STATE 
(You may require an interview with the 
operator to verify if this type of wait 
occurred,. and request information about 
system occurrence and messages printed 
prior to the wait state.) 



Turn to chart 05. 



Use the dump, or notes made by the 
operator, of low address storage and current 
PSW, and the list shown on the opposite 
page. Also, refer to section 2-E-3. 
Analyze the message in bytes 0—3 to 
isolate a possible cause of the error. 



Use the stand-alone output to locate: 

• the old PSW applicable to the message. 

• the instruction length code (Refer to 
section 2-E-2.) 

• the interrupt code. 

The reason for the error may be that a 
transient used by the program is not 
cataloged in the system core image library. 
Execute DSERV. (Refer to section 2-C-2.) 



Use the stand-alone dump output and 
supervisor listing to locate where in the 
supervisor the program check occurred (which 
routine). Analyze the failing instruction 
and compare the code of the instruction 
in the dump with the instruction in the 
listing. 



If GR 1 1 contains a hard wait code (see table 
opposite) or a hard wait code exists in bytes 2 
and 3 of low address storage, proceed to check 4 
If there is no recognizable message turn to 
chart 04. 



Calculate the failing instruction address by 
subtracting the length code from the instruc- 
tion address part of the PSW. Analyze the 
cause of the program check using the 
interrupt code. If you cannot isolate the 
error with this information proceed to 
check 5. 



Make certain that user routines have not 
altered the supervisor, and that the super- 
visor assembly is free of errors. Before 
calling for IBM programming support, 
execute the program with PDAID F/L trace 
on all partitions to trace phases used. (Refer 
to section 2-B-2.) 

Also, use the SDAID stop on event program 
check and obtain a non-destroying dump 
when the stop occurs. (Refer to section 
2-B-10.) 

If the error cannot be isolated after re- 
analysis of the problem using the output 
obtained from the re-run, inform IBM. 
Have the following information available: 

• SYSLOG output 

• Supervisor listing 

• Program listing 

• Linkage Editor maps 

• Stand-alone dump 

• Dump or copy of SYSVIS 

• PDAID and SDAID output 

• Job stream 

• DSERV output if one was obtained. 
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Hard Wait, no Message in Low Address Storage 
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Check Method of Analysis 



Check 1 



Scan the stand-alone 
dump output 



A. Look for unexpected or unreasonable 
values in the following areas in the dump 
output: 

• PSWs in low address area (machine check 
old, program old, input/output old, SVC 
old, external old), and note interruption 
codes for the associated PSWs. 

• General purpose registers. 

• Control registers (see appendix C). 

• CSWand CAW (refer to section 2-E-2). 

B. If the dump produces a formatted output, 
scan the LUB, PUB, CHANQ, PIB, and 
ERROR O. (Refer to chapter 3 in this 
section for a description of these supervisor 
tables.) 

C. Locate SYSCOM (address of SYSCOM is 
found at location X'80-83' of low address 
storage). 

D. Locate the logical transient area. The 
address of the LTA is found at X'1 C of 
SYSCOM. 

Convert the first eight bytes of the LTA to 
characters. This is the name of the transient 
in the LTA at the time the dump was taken. 
If it is a user-written transient, obtain a 
listing of the transient and check for the 
use of SVC 22 (Seize System). When the 
system is seized, no interrupts can occur 
until a second SVC 22 is issued to release 
the system. If the transient is supplied by 
IBM, inform IBM and have the following 
available: 

Supervisor Listing, Stand-alone dump, 
Jobstream, Program Listing, Linkage Editor 
maps, and SYSLOG output. 



Recommendations to Aid 
Further Problem Analysis 



• If the error cannot be isolated, re-run the 
program with SDAID IF trace function. Use 
FASTREC output class and specify as large 
an area as possible for SDAID (refer 
to section 2-B-10). 

Proceed to check 2. 



— Check 2 — 

Analyze the 
SDAID output 



Use the SDAID IF trace output to determine 
where the LPSW (load program status word) 
was given. The HARD WAIT is caused by a 
LPSW instruction that can be issued only 
when the system is in the supervisor state. 
For example, LPSW can be issued by the 
DOS/VS supervisor or any IBM routines that 
run in supervisor state. 



Compare the last few instruction addresses in 
the IF trace output with, for example, the 
supervisor listing, or if the instruction 
addresses are not in the supervisor area, the 
listing of the IBM routine which was running 
in supervisor state. Determine the routine in 
which the LPSW is issued. 

Inform IBM and haVe the following informa- 
tion available: 

• SYSLOG output 

• List of the IBM routine in which the LPSW 
instruction is issued, for example, the 
supervisor listing 

• Stand-alone dump output 

• SYSVIS dump or a copy of the PDS on 
tape or disk 

• SDAID IF trace output. 
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Method of Analysis 



Soft Wait 
CHART 05, PART 1 OF 2 



Recommendations to Aid 
Further Problem Analysis 



Check 1 - 

Establish task(s) 
waiting for input/ 
output interrupts 



Use the stand-alone dump output to locate 
the PI B. Make a note of the flag byte and 
address of the partition save area for each 
entry in the PIB. (How to locate the PIB and 
analyze information contained in an entry is 
described in Chapter 7 in this Section.) 



Proceed to check 2. 



Check 2 — 

Determine status of 
the partitions 



A. Determine the status of each partition by 
analyzing the flag byte. For example, a 
flag byte containing X'82' indicates that 
the task is waiting for an input/output 
interrupt. 

B. Locate the partition save area of each 
partition and make a note of the return 
PSW in each of the save areas. (Refer to 
chapter 1 1 in this Section.) 



Use the instruction address part of each 
return PSW to locate the instruction (in the 
dump) which will be executed when the 
partition regains control. If the sequence of 
instructions in the dump starting at this 
instruction is TM, BO, SVC 7, proceed to 
check 3. Otherwise go to check 4. 



Check 3 



Analyze the contents 
of general purpose 
register 1 



Determine if the contents of general purpose 
register 1 in the partition save area is pointing 
to a CCB. An example of a valid CCB is shown 
in Chapter 5 in this Section. 



If GR 1 is not pointing to a valid CCB proceed 
to check 4. 

If the contents of GR1 is pointing to a valid 
CCB, analyze the contents of bytes 2, 3, and 
12 of the CCB. (Refer to Chapter 5 in this 
Section for a description of the format and 
contents of the CCB). 

If the CCB is posted, check the seek address 
and unit check bits in the CCB. If you are 
using user-written unit check procedures, 
check that the sense data is properly tested. 

If the CCB is not posted, the device using this 
CCB is waiting for an input/output interrupt. 
Go to check 5. 



Check 4- 



Analyze the program 
or programs running 
when the wait state 
occurred. 



Use the program listing and linkage editor 
map* for each of the programs that were 
running, and, in conjunction with the instruc- 
tion address part of the return PSWs in the 
associated save areas, locate the instruction in 
each of the programs. 



*lf the program has been link-edited using the 
DOS/VS relocating loader option, the re- 
location factor must be calculated based on 
the start address of the partition used for the 
program when it failed. 



Determine the routine that was being executed 
in each of the programs running when the wait 
state occurred. Check the instruction coding in 
each routine for the correct use of macros, for 
example, the use of ENQ, DEQ, and WAITM 
macros. (A task may be waiting for a particular 
resource, or there may be acprogrammed WAIT 
for a timer control block.) 

If the track hold facility is supported, check 
that the maximum number of tracks specified 
in the TRKHLD parameter is not exceeded. 
Also ensure that one task is not waiting for 
tracks held by another task. 

For details about these macros and their for era 
mat refer to the IBM publication DOS/VS 
Supervisor and I/O Macros, and for examples 
of the use of these macros and multitasking, 
refer to the DOS/VS System Management 
Guide. 

If the error can not be isolated, proceed to 
Check 5. 
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Soft Wait 
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Check 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Check 5 

Analyze the last 
START I/O 



Inspect the channel bucket and analyze the 

contents to obtain information about the last 

input/output operation started on each 

channel. 

(Refer to Chapter 3 in this Section.) 



Proceed to check 6. 



Check 6 

Determine the I/O 
device involved 




Locate the associated PUB entry to 
determine the device address. (Refer to 
Chapter 3 in this Section.) 

Lo cate the associated LUB entry, (via the 
JIB if necessary), to determine the logical 
unit involved. 
(Refer to Chapter 3 in this Section.) 



Proceed to check 7. 



Check 7- 



Establish if there are 
other requests for the 
same device or if the 
CHANQisfull 



• Locate the channel queue, and check if any 
other input/output requests are queued for 
the same device. 

• Check the contents of FLPTR, if it is 
X'FF' the CHANQ is full . This may be an 
indication that the CHANQ is too small for 
the type of programs in use. 

(Refer to Chapter 3 in this Section.) 



Proceed to check 8. 



-Check 8 



Inspect the ERROR 
QUEUE 



Locate the error recovery block and check if 
there are any entries in the error queue for 
the device. 

From the error queue entry you can obtain 
the SSW, CCB address, and Message Code. 
Use the message code to locate the meaning 
and possible cause of the message by referring 
to the DOS/VS Messages manual. 
(Refer to Chapter 3 in this Section.) 



If the error can not be isolated, inform IBM 
of the problem, and have the following 
information available: 

• SYS LOG output 

• Stand-alone dump 

• SYS VI S dump or copy of the P DS on tape 
or disk 

• Job stream 

• Description of system environment and 
conditions under which the program is 
executed. 

Otherwise make corrections to your program 
as necessary. (This may require a new 
assembly of the supervisor, or re-running 
the program using a supervisor that can 
accommodate the required input/output 
operations.) 
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Method of Analysis 



Unintended Loop 
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Recommendations to Aid 
Further Problem Analysis 



Check 1 



Approximate location 
of the loop 



Check 2 



Eliminate 
components 



Use the trace of the loop (SDAID BR trace 
output or manual trace) and any notes made 
by the operator to inspect the path made by 
the loop. Also, use the linkage editor map and 
stand-alone dump to check if the loop 
addresses are within a module used by the 
program. 



• Is the loop in a user written module? 



Yes 



• Are any other programs using the same 
module? I 



Yes 



' Did these programs that use this common 
module generate unintended loops? 



No 



No 



No 



Yes 



If the loop is entirely within the supervisor 
area or in an IBM module used by the pro- 
gram or in an IBM-written program, inform 
IBM and have the following system informa- 
tion available: 

• SYSLOG output 

• Any output from the program 

• Job stream 

• Trace of the loop 

• Stand-alone dump 

• SYSVIS dump, or copy of the PDS 
■•Supervisor listing. 

' If the loop is not in the supervisor, or only 
part of it is, proceed to check 2. 



Loop is caused by the program. Proceed to 
check 3. 



Suspect the module of causing the loop. 
Proceed to check 3. 



Loop is very likely generated by the module. 
Proceed to check 3. 



Check 3 

Preparation for 
problem analysis 



A. If the loop is in the program, use the pro- 
gram listing, the trace of the loop, stand- 
alone dump, and program logic charts for 
analysis. 

B. If the module is suspected of causing the 
loop, use the listing and logic charts of the 
module for analysis. 



Also, check if any changes have been applied 
to the module since the last time the program 
ran successfully. 



Proceed to check 4. 



Remove the changes and re-run the program. 
Otherwise, proceed to check 4. 



Check 4 



Program and problem 
analysis 



A. Check program listing and logic flow for: 

• Count locations that can never reach 
their limits. 

• Counters that are not updated. 

• Counters that are never initiated. 

• Count locations, the contents of which 
are not periodically or properly tested. 

• Check that I/O operations are able to 
reach their completion, and are not 
prevented from doing so by program 
logic. 

B. Check the counter locations in the stand- 
alone dump. They may have been over- 
written, in which case use the program 
listing to isolate the point in the program 
where the locations are prepared. 

Note: Examine the channel programs if I/O 
operations are directly responsible for 
preparing count Ideations. 



■ If error cannot be isolated, re-run the program 
using SDAID BR and /or IF trace functions to 
obtain a complete trace of program and 
module logic flow during program execution. 
(Refer to Section 2-B-10.) 

Also, use PDALD F/L trace to check phases 

used by the program. (Refer to Section 2-B-4.) 

Re-analyze the problem. 

If the error can not be isolated, inform IBM. 

Have the following system information 

available: 

• SDAID output 

• SYSLOG output 

• Job stream 

• Program listing 

• Listing of module used (if module suspected) 

• Trace of loop 

• Stand-alone dump 

• SYSVIS dump or copy of PDS on tape or 
disk 

• RDAID output. 
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Incorrect Output not immediately detected 
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Check Method of Analysis 

Check 1 



Gather any information 
pertaining to program 



Recommendations to Aid 
Further Problem Analysis 



A. Ascertain System Environment (Super- 
visor, DOS/VS release number, I/O 
devices used, modules used, etc.) 

B. Obtain SYSLOG output from the job, and 
if possible the input job stream and input 
files. (This depends on many circum- 
stances, such as time involved, storage of 
output from previous runs, original input 
files already overwritten for other jobs 
etc.) 

C. Program listing and linkage editor map. 



D. Ascertain the status of the machine at the 
time the job ran. For example, find out if 
an I/O unit in use for the program 
developed an error and analyze its effects 
on the program. 



Turn to check 1 of chart 06 and analyze the 
problem using all available information. 
Try to simulate the same conditions for a 
re-run of the program. 
Use chart 06 for error isolation. 



Re-run program; execute a system dump 
or stand-alone dump when incorrect output 
is detected. 
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Check 



Check 1 - 

Type of program 
producing the 
incorrect output 



Method of Analysis 



■c 



Userwritten? 



IBM-supplied program? 

Assembly language 

High level language compiler (RPG II, 

FORTRAN, etc.) 

IBM library program (DSERV, SORT/ 

MERGE) etc. 



Recommendations to Aid 
Further Problem Analysis 



Proceed to check 2. 



Inform IBM and have the following informa- 
tion available: 

• All output from the program 

• SYSLOG output 

• Job stream 

• Input files 

• Supervisor generation notes and level of 
release 

• Listing of the support for the failing 
program 

• Notes about system type and model, and 
any notes about system status and input/ 
output units used for the program. 



■- Check 2- 

Type of incorrect 
output 



Use any output from the program and 
messages printed during program execution 
to determine the type of incorrect output 
according to the following categories: 



• Duplicate (identical lines printed) 



Lack of (missing data printed). 



• Too much or unexpected (more data printed 
than expected). 



Use the program listing and analyze the 
coding, checking for: 

• Unnecessary program loops in input/ 
output routines 

• Routines not being entered or completed 

• Overlaid input/output areas. 

If necessary, re-run the program using 
SDAID IF, SA, and G A trace functions. 
Specify event limits that will adequately 
cover routines that prepare output areas. 
(Refer to section 2-B-10.) 
Re-analyze the output from the re-run. 
If the error can not be isolated proceed to 
check 3. 



-Check 3 



System condition 
during program 
execution 



Were there any abnormal interruptions in 
computer operations during execution of the 
program? 



Yes 



No 



Were any abnormalities observed in system 
actions or response to messages by the 
operator during program execution? 



Yes 



No 



Analyze the possible effects of any interrup- 
tion, and re-run the program ensuring no 
interruptions. 



Re-run the program and note any unex- 
pected system actions. Ensure the correct 
response is given to messages issued. (Refer to 
the DOS/VS Messages manual). 
Use any notes made to analyze program logic. 
If necessary, re-run the program using with 
the SDAID IF trace to aid analysis of pro- 
gram logic. 
Check the input used for the program. 

Proceed to check 4. 
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Check Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Check 4 



Environment 



Was the program operating under POWER or 
POWER RJE? 



Yes 



Turn to part 5 of this chart, check 1 3. 



No 



Proceed to check 5. 



Check 5 



Job stream 



Check that the correct job stream was used for 
the program. This applies also to job streams 
cataloged on the procedure library. 
(Use PSERV to display the procedure 
library; refer to section 2-C-3.) 



If error isolated, make corrections as 
necessary and re-run the program. 

If error can not be isolated, proceed to 
check 6. 



Check 6 



Input used 



Isolate suspected areas on the input files 
by examining the output from the program. 
For example, a missing record in the 
output indicates the approximate area on 
the input file that may be in error. 



Check the labels and volume ID and extent 
information. Use LSERV and LVTOC, or 
for VSAM files use LISTCAT Access 
Method Services utility commands. 



A. Obtain a dump of suspected areas on the 
input files used. For VSAM files use the 
Access Method Services utility program 
PRINT command. (Refer to section 2-C). 

B. Check input/output file macro 
definitions in the program listing against 
characteristics of data on the input files. 
DTF (LIOCS), CCB (PlOCS) 

ACB, RPL,and GENCB (VSAM). 

Compare the output of the LSERV, LVTOC, 
and LISTCAT programs with DLBL/EXTENT, 
VOL ID, data in the job stream. 
If no errors can be found, proceed to check 7. 
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Incorrect Output detected during Program execution 
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Recommendations to Aid 
Further Problem Analysis 



Check 7- 

Dump of partition 



Did the operator obtain a dump of the 
partition containing the failing program? 
For example, a stand-alone dump, a system 
dump, or a dump obtained by using the 
DUMP command. 



Yes 



Inspect input/output areas in the dump, also 
inspect CCBs and channel programs. (Refer to 
chapter 5 in this section.) 
If no errors are found proceed to check 8, or 
if satisfied with the information that can be 
obtained from the dump go to check 10. 



No 



Proceed to check 8. 



Check 8 

Obtain a non- 
destroying dump 



Use the program listing and the information 
already obtained from the previous analysis 
of the problem to isolate the approximate 
area of the failure. 

For example, a specific input/output area, 
or a specific work area. 



■A. Re-run the program with SDAID IF and/or 
SA trace function. Specify a stop on event 
and obtain non -destroying dumps at specific 
instructions, or specific storage alterations. 
(Refer to section 2-B-10.) 

B. Also, as a further aid for problem analysis, 
use the PDAID F/L trace to trace phases 
used by the program. 

Proceed to check 9. 



Check 9 



Analyze the SDAID 
dump output 



Inspect input /output areas, CCBs, and 
channel programs in the non-destroying 
dump output. 

Compare input/output areas as defined 
in the DTFs, CCB and CCW macros, and 
ACB, RPL and GENCB macros in the 
program listing, with the areas as printed 
in the dump. 

Check the sequence, names, and load/ 
entry addresses of the phases used by the 
program, and compare them with the 
linkage editor map addresses. 
Use the program listing and dump output 
to inspect values in registers and storage 
locations used for intermediate results. 



If no errors can be found and the cause of the 
error can not be isolated, proceed to check 10. 
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Check Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Check 10 



Unusual conditions 
generated by the 
program and its input 



Check that the program logic and counters can 
accommodate unusual conditions and circum- 
stances of input. For example, data changes 
(year), or extraordinary changes in amounts 
and quantities. 



If the error can not be isolated, proceed to 
check 11. 



Check 11 

Preparation of the 
input files 




Check the input used for this program. If 
necessary, analyze the program that prepared 
the input files, starting at check 1 of this 
chart. 



If the input is correct, and the program that 
generated the input is not at fault, proceed 
to check 12. 



Check 12- 



Gather more system 
information 



Re-run the program, using, if possible, newly 
prepared input data that is known to be correct 
Try to simulate or run under identical condi- 
tions to those in which the failure occurred. 



A. Re-run the program with the PDAID F/L 
trace, to trace phases used by the program. 
(Refer to Section 2-B-4.) 

B. If you have not carried out the recommen- 
dations listed in checks 8 and 9 of this 
chart, initiate the SDAID IF, and/or SA 
trace functions. Use specific addresses for 
the event limits that are related to the 
problem, based on your previous analysis. 
(Refer to Section 2-B-10.) 

C. Before re-running the program, re-assemble 
it using the PDUMP macro to dump all 
input/output areas before and after every 
input/output operation. 

(Refer to Section 2-A-5.) 

If the program is using VSAM files, re- 
assemble the program and insert the 
TESTCB or SHOWCB macros, before 
and after each OPEN, GET and PUT. (Refer 
to Chapter 4 in this Section.) 

If, after re-analysis of the problem using the 
output from the re-run, the error can not be 
isolated, inform IBM and have the following 
information available: 

• All program output, whatever it is 

• All dump output 

• SDAID/PDAID output 

• SYSLOG output 

• Job stream 

• Any notes pertaining to the problem 

• Notes about system environment and 
condition. 
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Check 

Check 13 

Eliminate 

components 

used. 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



• Without initiating a POWER partition or 
running under POWER RJE re-run the 
program producing the incorrect output. 



• Are other programs generating incorrect 
output when running under POWER or 
POWER RJE 



a 



If program still generates incorrect output, 
analyze the problem starting at check 1 of chart 
06, part 1 . Otherwise suspect the POWER or 
POWER RJE partition and proceed to check 14 



Yes 



Proceed to check 1 4 



- Check 14 — r 

Programs falling 
which run under 
control of POWER 
or POWER RJE 



Inspect the contents of general purpose register 
7 printed at the beginning of a system dump or 
stand-alone dump executed just before the 
malfunction occurred. This register should 
contain the address of the TIB of the active 
POWER or POWER RJE routine just before the 
dump was executed. 



If the program is run under POWER consult 
Appendix K, or if run under POWER RJE 
Appendix L. 

By using the system information and Appendix 
K or L (as applicable), you may be able to 
isolate the cause of the error. In any case it is 
recommended that you inform IBM of the 
problem and have the following information 
available: 

• SYSLOG output 

• Stand-alone dump 

• A dump, or copy of SYSVIS 

• Dump of the QFILE 

• Supervisor assembly listing 

• POWER SCP assembly listing 

• Job stream 

• Any notes made during system operation 
when the malfunction occurred. 

You may re-run the program under POWER or 
POWER RJE with the following aids. 

A. Use PDAID I/O or QTAM trace functions to 
trace I/O operations on all units used by the 
program producing incorrect output, and by the 
partition owning POWER/POWER RJE. (Refer 
to section 2-B-4). 

B. Use SDAID BR function on the partition 
owning POWER to trace the logic flow during 
program execution (Refer to section 2-B-10). 

C. As an option, re-run the program using 
PDAID F/L trace on the partition owning 
POWER to trace phases used. (Refer to section 
2-B-4). 
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Program canceled by Program Check 



Check 



Check 1- 



Type of 
cancellation 



■M 



Method of Analysis 



Program Check. 
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Recommendations to Aid 
Further Problem Analysis 

Proceed to check 2. I 



Illegal SVC. 



Other(for example, operator cancellation) 



]|— ^»» f~Turn to chart 10. 



Turn to chart 1 1 . 



Check 2 



Area of failing 
instruction 
(Level 1) 



Is the program check in the SVA? 
There are two methods to establish this: 

1 . From the MAP command output check if 
the instruction address shown in the Program 
Check message is within the SVA. 

(The MAP command should have been issued 
immediately after the Program Check occurred) 

2. If a System Dump was executed when the 
Program Check occurred and the Program 
Check was in the SVA, a dump of the SVA (or 
part of it) will be preceded by the following 
message printed in the dump output: 

PART OF SVA WHICH CAUSES ERROR 



Yes 



No 



If a System Dump was executed, you may be 
able to isolate the error by using the information 
already available to you. If this is the case, go to 
check 1 3 on part 4 of this chart. 

If a System Dump was not executed, it will be 
necessary to re-run the job and include the 
// OPTION DUMP statement in the job stream 
before going to check 1 3 on part 4 of this chart. 
Also initiate the SDAID dump on event Program 
Check (refer to Section 2-B-10) and if your 
system suports PDA ID, initiate a FETCH/LOAD 
trace to trace the phase being loaded in the 
SVA. (Refer to Section 2-B-4). 



■^► j Proceed to check 3 



Check 3 



Area of failing 
instruction (Level 2) 



Use the load and entry addresses of phases and 
modules used by the program as indicated on 
the linkage editor map,* and the error message 
to locate in which area the program check 
occurred: 



[ • Program check in user program area 



•Program check within the supervisor area 
(The address of the end of the supervisor is 
contained in bytes X'20'-X'23' of SYSCOM^ 
and the address of SYSCOM is contained in 
bytes X'80'-X'83' of the low address storage.) 



► Program check within the partition con- 
taining the POWER or POWER RJE system 
control programs 




Proceed to check 4. 



Turn to chart 1 2. 



-»4 



Turn to chart 1 3. 



Check 4 



Location of failing 
instruction 



Use the linkage editor map as in check 2 above, 
to determine whether: 

• the program check is within the user-written 
program, 

• or in a user -written module used by the 
program. 

Note: 

If the program check is within an IBM-supplied 

module used by the program, and no system 

dump was executed when the program check 

occurred, re-run the program with the 

// OPTION DUMP statement in the job stream. 

(Refer to Section 2-A-2) Otherwise inform IBM 

and have the following information available; 

• SYSLOG output 

• Job stream 

• System du mp output 

'•Program listing and linkage editor map. 



Proceed to check 5. 



*lf the program has been link-edited using the 
DOS/VS relocating loader option, the re- 
location factor must be calculated based on 
the start address of the partition used for the 
program when it failed. 
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Check 5 

Analyze failing 
instruction and 
type of program 
check 



Method of Analysis 



Can the cause of the failure be isolated using 
the program listing, error messages, and job 
stream? 



Yes 



No 



Recommendations to Aid 
Further Problem Analysis 



Make correction as necessary and re-run the 
program. 



•^^\ Proceed to check 5. 



Check 6 



Dump of 
partition available? 



Was a system dump executed when the 
program check occurred? (System dump is 
described in Section 2-A-2). 



Yes 



No 



Proceed to check 7. 



Re-run the program with // OPTION DUMP 

statement in the job stream. 

Also, use the SDAID stop-on-event program 

check and obtain a non-destroying dump. 

(Refer to Section 2-B-10.) 

When you have obtained the dumps 

continue problem analysis from check 7 of 

this chart. 



Analyze dump of 
partition (Level 1) 



Use error messages, linkage editor map*, and 
program listing to locate failing instruction in 
the Dump. 
(An example is shown in Section 2-E-3.) 



A. If the instruction and code appears correct 
and has a valid operation code and data 
field, proceed to check 8. 

B. If the program check message indicates an 
error in input/output operation in your 
program, go to check 10; otherwise proceed 
to check 8. 



— — Check 8 - 

Analyze dump of 
partition (Level 2) 



A. Locate the partition save area and inspect 
the contents of general purpose registers. 
(The location and format of partition save 
areas are described in Chapter 1 1 of this 
Section.) 



Use program listing, and linkage editor 
map* to locate data areas in the dump used 
by the failing instruction. 



Look for unreasonable or totally unexpected 
values in the general purpose registers. If you 
find any that are connected to the failing 
instruction, locate the code in the program 
listing responsible for preparing the register(s). 
(General register usage is described in 
Chapter 9 of this Section.) 
If the cause of the error can not be isolated, 
proceed to check 9. 



Depending on the type of program check 
indicated by the error message, inspect data for 
validity, duplication, missing information, and 
sequence errors. 

If the cause of the error cannot be isolated, 
proceed to check 9. 



*lf the program has been link-edited using the 
DOS/VS relocating loader option, the 
relocation factor must be calculated based on 
the start address of the partition used for the 
program when it failed. 
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Check 



Method of A nalysis 



Recommendations to Aid 
Further Problem Analysis 



CheckS- 



Analyze the general 
register and data 
preparation 
instructions 



Inspect the program logic and instructions 
responsible for preparing the general 
registers and data areas used by the failing 
instruction. 



If an input/output operation is involved, 
proceed to check 10; otherwise, go to check 1 1 



Check 10- 

Analyze the input/ 
output operation 



Locate and inspect command control blocks 
(CCBs) and channel programs in the system 
dump as described in Chapter 5 in this Section. 
Note: to locate and analyze CCBs and channel 
programs for programs using VSAM 
files, consult the description given in 
Chapter 4 in this Section. 



If it is an input operation, and this input is used 
to prepare the general registers or data fields 
used by the failing instruction, you may suspect 
the program that produced the input. 
Proceed to check 1 1, or first analyze the 
program that provided the input to this program 
by following the recommendations given in 
chart*08 (incorrect output). 



Check 11 — 

Prepare a program 
re-run to gather more 
detailed system 
information 



A. Use SDAID SA and/or G A trace functions if 
you suspect that data of general register 
alteration is the cause of the error. Specify 
address limits on the suspected areas 
calculated from the start of the partition in 
which the program is re-run. Refer to Section 
2-B-10.) 
Note: the SA trace can not be used to trace 

areas altered directly by input/ 

output operation. 
If the logic flow of the program during 
execution is in doubt, use the SDAID BR 
trace function on the partition in which the 
program is re-run. 



B. If the program is running in virtual mode or 
using user written channel program 
translation routines, use SDAID stop-on- 
event program check and obtain a non- 
destroying dump. (See note) 

(Refer to Section 2-B-10.) 

C. If the program is running in virtual mode 
and using the IBM-supplied channel pro- 
gram translation routine, check that your 
program is not violating the rules for 
channel program translation support. 



Proceed to check 1 2. 



Check the general rules applicable to channel 
program translation routines. (Refer to 
Chapter 1 3 in this Section.) 



Note: The SDAID non-destroying dump 

enables you to analyze the CCB/CCW 
copy blocks and the CCW/TCB in 
the supervisor area. Note that these 
blocks may be overwritten by the 
system dump when analyzing the 
output from a system dump. 
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Check 12 

Re-analyze the 
output from the 
program re-run 



Use ail the information obtained from the re-run 
and re-analyze the problem. If the error cannot 
be isolated, you may either inform IBM or re- 
assemble the program, inserting one or more of 
the following assembly macros in your 
program. Then re-run the program. 



• PRINT GEN (to obtain an expansion of all 
macros in used by the program). 

• PDUMP (to obtain the dumps of selected 
areas of storage, such as input/output areas, 
during program execution. Refer to Section 
2-A-5) 

• DUMP or JDUMP (to obtain a dump of 
partition and supervisor at a point in the 
program before the program check occurs. 
Refer to Section 2-A-5.) 



If you choose to inform IBM, have the 
following information available: 

• SYS LOG output 

• Job stream 

• SDAUD output 

• Program listing and linkage editor map. 



Re-analyze the problem using output obtained 
from the re-run. Examine the expansions of 
macros used by the program and check the 
DTF macros used for file definition with the 
program listing. 

If the error can not be isolated, inform IBM 
and have all information obtained from program 
re-runs, plus any notes made of your previous 
analysis. 



■Check 13 



Analyze dump 
of the SVA 



If it is known which program or phase 
in the SVA caused the program check, 
use error messages and program listing 
to locate the failing instruction in the 
dump. (An example is shown in Section 
2-A-2 of this manual). 

If the name of the phase in the SVA 
that caused the program check is not 
known, use the PDAID FETCH/LOAD 
trace output to locate the last phase 
used by the program. 
The load address of the phase should be 
the start address of the SVA printed in 
the dump. 



Compare the hex code of the failing 
instruction given in the assembly listing 
with the hex code in the dump output. 
If the instruction and code appears to be 
cor feci and has vaiid operation code and 
data fields specified, continue problem 
analysis from check 8 on part 2 of this 
chart. 

If the program check message indicates an 
error in I/O operations, continue problem 
analysis from check 10 on part 3 of this 
chart. 
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Program canceled by Illegal SVC 

SUPPORT FOR CHART 10 



The complete text for message 0S04I is: 

ILLEGAL SVC- HEX LOCATION nnnnnn - SVC 
CODE nn 

where nn is in hexadecimal notation. 

This message results from the following causes: 

1. When nn is 02: The phase name given does not start with 
$$B, or 

For LIOCS, macros called in invalid sequence. As a result, 
on SVC 8 is issued after an SVC 2 before an SVC 9 has 
been issued to free the transient area, or 

For other conditions, the user specified a temporary exit 
(SVC 8) for a logical transient. In the temporary exit 
routine, another routine is called (by an SVC 2) before 
an SVC 9 is issued to free the transient area. 

2. When nn is 05: The 'to' range specified in the MVCOM 
macro is invalid. 

3. When nn is 0A, 1 2, 1 3, or 1 8: The supervisor was 
generated without the timer option. 

4. When nn is OB: The call was not given by a logical 
transient routine. 

5. When nn is 1 6, 1 7, or 1 A: The caller did net have a PSW 
key of zero. This is applicable only in a multiprogramming 
system. 

6. When nn is 23: More than 16 holds have been issued for 
the same track. 

7. When nn is 24: Free a non-DASD or a track that is not 
held. 

8. When nn is 26: A subtask issued attach, or the save area 
is not on a doubleward boundary. 

9. When nn is 27: A main task issued detach without 
SAVE = parameter, or 

A main task issued detach, but the ID of the subtask in 
the save area passed is not valid, or 

A main task attempts to detach on already terminating 
subtask. 

10. When nn is 29: A DEQ is issued by a task that did not 
ENQ the resource. (This is valid in an AB routine.) 



1 1 . When nn is 2A: A subtask (without an ECB = parameter) 
has issued an ENQ macro, or 

A subtask has issued an ENQ macro to a resource that 
has not been dequeued by another task that has been 
terminated, or 

A task has issued two ENQ macros to the same resource 
without an intervening DEQ. 

12. When nn is 2D: Emulator execution was attempted, but 
the EU parameter of the SUPVR macro was omitted or 
incorrectly specified during system generation. 

13. When nn is 32: For LIOCS: 

a. An imperative macro (such as WRITE or PUT) was 
issued to a module that does not contain the 
requested function, or 

b. A PUT was issued for an ISAM retrieve module 
without a preceding GET, or 

c. An invalid ASA first character for the printer 
was used, or 

d. A wrong length record indication occurred while 
processing 1287 documents when 
RECFORM=UNDEF,or 

e. The 1287 program erroneously contained a CCW(s) 
with the SLI flag bit 'OFF', or 

14. When nn is any other value: The supervisor function 
requested by the operand of the SVC is not defined 
for the supervisor being used. 



Causes for Message 0S04I (Cancel Code X'21') 
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Check 



Check 1 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Supervisor support for 
the SVC code printed 
in the error message 



Use the supervisor listing to check if the option 
used by the SVC is supported. For example, 
SVC X'43' must be supported by a supervisor 
generated with PFIX = YES. 



Compare the SVC code printed with the list of 
SVCs given in Chapter 6 of this Section. 



If the option is not supported, avoid the use 
of the SVC by the program, or re-assemble 
the supervisor, or re-run the program using 
a supervisor that supports the option. 



If the SVC code printed in the error message is 
not listed, go to check 3. 
Use the figure opposite to isolate possible 
causes of error if the error message is 0S04I. 
If the option is supported and no reason can be 
established for the error, proceed to check 2. 



Check 2 



Location of SVCs 
issued by the program 



Use the program listing and linkage editor map* 
to locate where the SVC is issued. 
Note: To ensure that all SVCs issued by the 
program are checked, use a program listing 
that shows the expansions of the macros used. 
(If such a listing is not available, you will have 
to re-assemble the program with the 
PRINT GEN assembly control statement.) 



Check the sequence of SVCs issued and macros 
used to ensure that the program is written to 
enable correct use and sequence of SVCs. 
If there is any doubt about the sequence of 
SVCs issued by the program, re-run the 
program with the PDAID GSVC trace. (Refer 
to Section 2-B-4.) If the error can not be 
isolated, proceed to check 3. 



Check 3 



Dump of partition 



Was a System dump taken when the program 

check occurred? 

(System dump is described in Section 2-A-2.) 



No 



Re-run the program with the // OPTION DUMP 
statement in the job stream, or initiate the 
SDAID dump on event program check (refer 
to Section 2, B-10-F). 



Yes 



Proceed to check 4. 



Check 4 — 

Analyze the dump 



Use the program listing, error message, linkage 
editor map*, and system dump to locate the 
SVC instruction in the dump.. 



If the program has been link edited using 
the DOS/VS relocating loader option, the 
relocation factor must be calculated based on 
the start address of the partition used for 
the program when it failed. 



Compare the hexadecimal code for the SVC in 

the dump with the SVC instruction in the 

program listing. 

If there are differences, analyze the program 

to isolate the point where the correct SVC 

instruction is overwritten. 

As a further aid in this analysis, you may need 

to re-run the program with the SDAID SA 

trace. Use the STOP ON EVENT option and 

obtain a non-destroying dump at the point 

suspected of causing the overwriting. 

If there are no differences and the error can not 

be isolated, inform IBM and have the following 

ingormation available: 

• Supervisor listing 

• Program listing, including the macro 
expansions 

• Linkage editor map 

• System dump 

• SYSLOG output 

• Job stream. 
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Check 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Check 1 



Reason for program 
cancelation 



Did the operator cancel the program? 



Yes 



Inspect messages printed on SYS LOG and 
SYSLST prior to the cancelation. If necessary, 
interview the operator to establish system 
activity during program execution. (It is possible 
that incorrect response to messages issued during 
program execution caused an unusual condition 
to occur.) 
Proceed to check 2. 



No 



Examine the program listing and check for 

the use of DUMP or CANCEL macros left in 

the program from testing phases (program 

testing). 

Remove these macros and proceed to check 2. 



Check 2 



Re-run the program 



Re-run the program. If possible, be present 
during the re-run to observe system activity. 
Follow the recommendations given in DOS/VS 
Messages manual, and ensure the correct 
response is given to messages issued during 
program execution. 

Ensure the use of the // OPTION DUMP state- 
ment in the job stream, to obtain a system dump 
when the program is canceled. (Refer to 
Section 2-A-2.) 



If the identical error recurs, it may be due to 
the incorrect use by the program of an IBM- 
supplied routine. 

Inform IBM and have the following information 
available: 

• SYSLOG output 

• SYSLST output 

• System dump output 

• Job stream 

• Program listing and linkage editor map. 
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Check 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Check 1 



Approximate the area 
where the program 
check occurred 



is the program check within the logical 
transient area? (Message 0S08I followed by 
message 0S1 1 1 will inform you where the 
instruction address, (the program check 
occurred) is located. 




Go to check 8. 



Yesr 



Proceed to check 2. 



Check 2 



Dump available? 



Was a system dump executed at the 
occurrence of the program check? 
(Refer to Section 2-A-2.) 



No 



Yes 



Re-run the program with the //OPTION DUMP 
statement in the job stream. Also, initiate the 
PDAID transient dump program, described in 
Section 2-A-4, or use the SDAID stop-on-event 
program check function and obtain a non- 
destroying dump. (Refer to Section 2-B-10.) 
After the re-run, go to check 4. 



Proceed to check 3. 



Check 3 



Analyze the system 
dump to determine the 
name of the logical 
transient 



Use the system dump to locate the partition 
save area. (Refer to Chapter 12 in this Section.) 
Locate the return PSW in the save area and 
determine the failing instruction address. 
Locate this address in the dump and go two 
bytes to the left. 

Is the contents of these two bytes X'0A02' 
(SVC 2)? 



Re-run the program and initiate the PDAID 
transient dump program as described in 
Section 2-A-4, or use the SDAID stop-on-event 
program check function and obtain a non- 
destroying dump. (Refer to Section 2-B-10.) 
(Also include the //OPTION DUMP statement 
in the job stream to obtain a system dump.) 
Proceed to check 4. 



Locate the general purpose register 1 in the 
save area. This consists an address. 
Locate this address in the dump and convert 
the first 8 bytes, starting from this address, to 
characters. This is normally the name of the 
logical transient fetched by the program. 
(For OPEN or CLOSE register 1 may point 
to the DFT). 

Note: The cause of the program check need not 
necessarily be in this transient, since a logical 
transient may need to fetch another transient 
to complete a service. The program check 
could therefore be caused by incorrect para- 
meters being passed to the transient. 
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Check 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Check 4 



Determine the 
name of the logical 
transient fetched 



Use the PDAI D transient dump output to 
determine the name by converting the first 
8 bytes of the dump to characters. (Refer to 
the example of a transient dump output given 
in Section 2-A-4.) 



Use the SDAID non-destroying dump output to 
locate Byte X'1 C of SYSCOM which contains 
the address of the logical transient area. 
(The address of SYSCOM is contained in 
bytes X'80-83' of the low address storage. 
(Refer to Section 2-E-2.) 
The first 8 bytes of the LTA, when converted 
to characters, give the name of the logical 
transient fetched. 



Proceed to check 5. 



•Check 5 



No 



Type of logical 
transient program 



Is the logical transient user-written? 



Use the problem program listing and the system 
to determine the routine that was being 
executed when the program check occurred. 
Then determine which macro in the routine 
was responsible for fetching the logical 
transient. For example, the OPEN macro will 
cause the logical transient $$BOPEN to be 
fetched. 

If the error can not be isolated, inform IBM and 
have the following information available: 

• SYS LOG output 

• PDAID/SDAID output (if available) 

• Job stream 

• Supervisor listing 

• Program and transient assembly listings 

• Linkage editor maps. 



Yes 



Proceed to check 6. 



Check 6 



PDAIDor SDAID out- 
put available? 



To complete problem analysis you will require 
the PDAID transient dump output, or a non- 
destroying dump output from the SDAID 
program. 



If you have already re-run the program and 
obtained one or both of these dumps, proceed 
to check 7. Otherwise, re-run the program, 
following the recommendations given in check 2 
before proceeding to check 7. 
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CHART 12, PART 3 OF 3 



Check 



Method of Analysis 



Check 7- 



Analyze the dump of 
the logical transient 
area 



Use the PDAID/SDAID output and the 
assembly listing of the logical transient fetched 
to locate the failing instruction address in the 
logical transient area. 



A Locate the general registers at the top of 
the dump. 



J 



Locate data preparation areas that are used 
by the failing instruction in the dump. 
Check the instructions in the assembly 
listing of the Logical Transient that is 
responsible for preparing data areas for use 
by the failing instruction. 



Recommendations to Aid 
Further Problem Analysis 



l~L 



Look for unreasonable or totally unexpected 
values in the registers. If you find any that are 
connected with the failing instructions locate 
the code in the assembly listing that is 
responsible for preparing the register (s). 
If the contents of the general registers 
appear to be correct proceed to check 8. 
(General Register usage is described in 
Chapter 9 of this Section). 



Depending on the error message, inspect data 
used by the failing instruction for validity, 
duplication, and missing information. 

If the error can not be isolated, inform IBM 
and have the following information available: 

• SYSLOG output 

• PDAID/SDAID output 

• Job stream 

• Supervisor listing 

• Program and transient assembly listings 

• Linkage editor maps. 



-CheckS- 



lsolate area in the 
supervisor causing the 
program check 



Use the error message and assembly listing of 
the supervisor to determine in which routine 
in the supervisor the program check occurs. 



Before informing IBM of the problem, re-run 
the program with the SDAID stop-on-event 
program check function and obtain a non- 
destroying dump when the program check 
occurs. (Refer to Section 2-B-10.) 
Have the following information available. 

• SYSLOG output 

• Job stream 

• SDAID output 

» Supervisor listing 

• Program listing and linkage editor map. 
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Program canceled by Program Check in POWER or POWER RJE 



CHART 13, PART 1 OF 2 
Check 



- Check 1 

Job flow 



Method of Analysis 



Yes 



Recommendations to Aid 
Further Problem Analysis 



Were there any interruptions in normal 
system operations during program execution? 
For example, input/output device problems, 
necessitating a change in I/O devices assigned, 
or waiting times, or changes to jobs using 
POWER/POWER RJE during job execution. 



I 



Re-run the program ensuring no interruptions. 



No 



Yes 



Have any PTFs (IBM supplied program 
temporary fixes) been applied to the POWER/ 
POWER RJE program since the program last 
ran successfully? 



I 



If possible have the PTF removed and re-run 
the program. 



No 



Yes 



Has an identical program check occurred 
before when running this program under 
POWER/POWER RJE? 



No 



Go to check 3. 



Proceed to check 2. 



Yes 



— Check 2 — 

Dump of the 
POWER/POWER RJE 
partition 



Was a system dump executed when the program 

check occurred? 

(Refer to Section 2-A-2.) 



No 



If the program is running under POWER, 
analyze the dump using the illustrations 
shown in Appendix K. If the program is 
running under POWER RJE, analyze the dump 
using the illustrations shown in Appendix L. If 
the error can not be isolated, go to check 4. 



Re-run the program with the //OPTION 
DUMP statement in the job stream. Also 
initiate the SDAID stop on event program 
check and obtain a non destroying dump 
when the program check occurs. 
(Refer to Section 2-B-10). 
If the error can not be isolated go to check 4. 
If the program is running under POWER, 
analyze the dump using the illustrations 
shown in Appendix K. If the program is 
running under POWER RJE, analyze the 
dump using the illustrations shown in 
Appendix L. If the error can not be isolated 
go to check 4. 
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Check 



Check 3 



Program check 
occurred before 



Method of Analysis 



Was a note of system activity and environment 
made when the identical program check 
occurred in any previous run of the program? 



Yes 



No 



Recommendations to 
aid further Analysis. 



Compare note made with the conditions and 
environment under which this program check 
occurred again. Proceed to check 4. 



Make note of the system environment and I/O 
units involved. Also note the I/O files in use. 
Proceed to check 4. 



Check 4 



Gather more system 
information 



Re-run the program with the PDAID F/L trace 
to trace phases used. Also use the DIAG 
parameter to trace SVCs issued by the POWER 
or POWER RJE SCP. (Refer to Appendix J). 



Re-analyze the problem using the output from 

the re-run and information obtained from your 

previous analysis of the problem. 

If the error can not be isolated, inform IBM 

and have the following information available: 

o Program output 

o SYSLOG output 

o Job stream 

o Supervisor listing 

o POWER or POWER RJE assembly listing 

listing and linkage editor map 
o Any notes made about system environment 
o I/O units used and system condition 
o PDAID output 
o POWER DIAG SVC trace output. 
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CONTENTS 



4. 



10 



General organization of virtual storage 

Communication regions 

Partition Communication Regions (COMREGs) 

System Communication Region (SYSCOM) 
Supervisor I/O tables and information blocks 

LUB, NICL and FICL 

PUB and FOCL 

Device Type Codes 

PUBOWNERSHIP 

JIB, FAVP 

CHANQ, and FLPTR 

Channel Control Table and Channel Bucket 

Error recovery Block and ERRQ 

DOS/VS Input/Output Control System (IOCS) 

Using Physical IOCS and Logical IOCS 

Imperative and Declarative Macros 

VSAM file definition macros and control blocks 

Command control block (CCB) and channel programs (CCW) 

DOS/VS Supervisor calls (SVC) and their functions 

Program information block (PIB and PIB2) 

DOS/VS Cancel Codes 

General purpose register usage 

By DOS/VS 

For programmer use 

By JOB ACCOUNTING 

By POWER 

By POWER RJE 



,ik_ 



User exit routine support 

IT (Interval Timer) 

AB (Abnormal Termination) 

PHO (Page Fault Handling Overlap) 

PC (Program Check) 

OC (Operator Communications). . . 

1 1 . Save areas 

Partition save areas" 



User exit routine save areas 

System save areas 

Save area for JOB ACCOUNTING 

12. Tables required by the PAGE MANAGEMENT routines 

The segment table 

The page table 

The page frame table and extension 

The boundary box 

Converting virtual addresses to real • 

Converting real addresses to virtual 

13. Channel program translation 

The IDAL block 

The CCB copy block 

The CCW copy block 

CCW/Translation Control Block 

Fix Information block 

Rules applicable for channel program translation ; . . . . 

Note: Contents and addresses shown in the illustrations are subject to change and are shown only as an aid to offline 
debugging of DOS/VS release 28. 

IBM will not be responsible for any system malfunction resulting from a change made by the user to any 
contents or addresses of the tables and blocks described. 
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The figure below illustrates the general organization of virtual storage. 

The supervisor is loaded in the real address area beginning at virtual address byte 0. 
Virtual storage can extend up to 16 million bytes. The figure also shows the general 
organization of the supervisor. Each area within the supervisor is described in more 
detail in this Section, except for the low address area and the PD area which are 
described in Section 2. 



GENERAL ORGANIZATION 
OF VIRTUAL STORAGE 



i 


i 


Supervisor 




BG-R 




F4-R 


Rea 


F3-R 


Address 


F2-R 




' 


F1-R 


< 


Main Page Pool 
(for programs 
executing in 
virtual mode) 


i 


i 


BG-V 

(Minimum always 
64K) 




F4-V 


Virtual 

Address 

Area 


F3-V 




' 


F2-V 




F1-V 


< 


Shared Virtual Area 
(not applicable to a 
single partition system) 



Partitions 

(See note) 
Background 

Foreground 4 

Foreground 3 

Foreground 2 

Foreground 1 



Low address storage 



For details, 

see Section 2-E-2. 



CPU model-dependent logout area 



Background communication region 



System communication region 



Save areas 

Option tables 

I/O tables and information blocks 



F1 Foreground communication 

F2 regions (One for each 

F3 partition specified during 

F4 system generation) 



Logical transient area (LTA) 



Physical transient area (PTA) 



PD area (optional) For details, 

see Section 2-B-3 



CCW translation routines 



Page management routines 



VSAM routines 



Machine check handler, 
Channel check handler. 



RAS transient area (RTA) 



Page management tables, 
CCW translation copy blocks 



Supervisor organization 



Note: Up to five partitions may be specified: one background and four fore- 
ground. Each partition consists of the pair "real partition - virtual 
partition ". 

The SVA and each virtual or real partition must be a multiple of2K. It may also, 
however, be 0K, except the SVA andBG virtual which must be at least 64K. 
To be active a foreground partition must have a virtual partition of at least 64K. 



Figure 4.1 The organization of Virtual Storage. 

The organization of the supervisor area is also illustrated and parts of it are described in 
this Section. 
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Partition Communication Regions, (Comregs) 

In a multiprogramming system individual communication regions are defined for 
each partition. The communication region (comreg) belonging to the active 
partition is an area that serves as an initial pointer to other supervisor tables and 
areas. The comreg also contains pointers to user program tables and areas. The 
MVCOM and COMRG macro instructions enable access to information contained in 
these regions. Fields in the comreg are addressed relative to the first byte. The com- 
munication regions are located within the supervisor and their format is described 
in Figure 4.2 and Figure 4.3, parts 1 through 6, explain the contents of each field. 



Example A 



Locating the partition communication regions 

After IPL, low address storage bytes X' 14— 17' contain the address of the comreg 
used by the active partition. 

Note: The contents of these bytes will not be valid after executing the stand-alone 
dump program. Therefore, it is important for the operator to dump, or display 
and note, the contents of low address storage before executing the stand-alone 
dump. Locate bytes X'7C and '7D'in the active comreg. This is the address of 
PIB2, also referred to as the PIB (program Information Block) Extension. The first 
two bytes of an entry in the PIB2 contain the address of its associated comreg. 
(Refer to Chapter 7 in this Section for a detailed description of the PIB2.) 

Example A below shows a dump of low address storage. Bytes X'14— 17' contain 
the address 04A0. This address has then been located in a stand-alone dump output 
as shown in example B. The address of PIB2 is indicated in this example. 
Example C shows the PIB2 from which the addresses of all the partition comregs 
are found. 



..l iM...<Kiaoo.ft ^^McCaC*Mofa<!i ! £^ 

I 00000000 00000000 00000000 00000000 00000000 OOO rtOjAAQ) 40000000 00000000 " 
4.Z0.DG0.O.O Q0.040.C3C 4.40.C00.0.0 00001366 -..OOOOOOOO 00000000 470F20O0 



Example B 



07B7E0 E2C9C4C5 



000000 
000020 
000040 
000060 
000080 
0000A0 
OOOOCOi 
ACT 
0004CB 
0004E0 
000500 



)900*619 
47000000 
0007B038 
44OCO0O0 
00000540 
00000000 
00000000 
F1F261F0 
00060FFF 
41044296 
46300000 



Ao&W) of ' ac/rtC 



40E2E306 09CIC7C5 40E4D5C3 C8C105C7 C5C4C3C8 C1D5C7C5 C4404004 c j— / J J y , jt— J. 

/TjL , owttei- /l/bnix. cte*yi ffUMO* 

Ah POO (00000000 ) 4B4B4B4B 4B4B4B4B «. .4./.../. 

^* 000 00000000 470F2000 0000090C 

900 01AAAB17 00080000 OOO0A67E C 

UUW.O000 0007B3AA 00080000 0000A67E .....0 

10043010 00010000 00000000 000001EO . . . .............. 

00000000 00000100 60O0000C 00000000 C&toU* XyC— ~ 

00000000 00000000 05064005 C1D4C540^ \ X 70 ......NO NAME 

000BFFFF FD7FCE03 1000CE50 002E40WT AjLAeM o< P/OO L...S.. . 

F2F0F6F7 F3F3F4F0 00003CD4 QOJIPJ03C V. /70W?» yrf/3< 673340.. 

00008090 00007118 00003864 C3BDtf iA30 ' *' 'f£k f/ ftr) 



v/uwuoCl UUm.ll 



OOOOOOOO 
00000000 
— SAME— 
F661F7F3 
00043067 
42974389 
30CC3E4C 



00020007 
20000060 

70007000 
OOOOOOOO 
3FO03F06 
3EBC0010 



UUUUA3TU 

00040005 
0000 02C 



OOOOOOOO 
00000010 
3F0C38F1 
OOOOOOOO 



Example C 



003B60 
003880 
003BAO 
003BC0 
003BE0 
003C00 



27000000 40000001 03003P' 



Ac6fa<> <f Sq <»**#«. 

LLnLTlI'.l."'"""""" ""^"V" """""""" 



.. 6000P r 

38P4 a^**^ "": 

uuuul 



OOOOOOOO 'C4 AOI IOO0 00020007 .QQpppQOO . . 

0200000.144^01)062 ' bb'o'doobb 60000600" 

003C20 . g040000oT43BOQOBA OOOOOOOO 0_00OQQO0_ 



06/0062000B OOOOOOOO I "^ 

1 1 



PIB2 



9 3200C2C7 80040000 <O0006458' «O0E288O 



00100000 K4590TJ 036 OOOOOOOO OOOOOOOO I 
*003d6o6o ft450J0aE OOOOOCOO OOOOOOOO I 

O050ooooj i o6y^^ ft *mjmm>t> iim»»wwn ' 

Aehben <f fZ <c**<**«a/ •••• ar.......v 

8000C6F4 80007000 00006518 BG F4 (, 
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FnCOMREG* 

Displacement 
hexadecimal 
Displacement 
decimal 



Displacement 
hexadecimal 
Displacement 
decimal 



Displacement 
hexadecimal 
Displacement 
decimal 



Displacement 
hexadecimal 
Displacement 
decimal 



Displacement 
hexadecimal 
Displacement 
decimal 
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8 
8 


OA 
10 


OC 
12 


17 
23 


18 
24 


20 
32 


24 
36 


28 
40 


?c 

44 


Date 


Address of 
PPBEG 


Address of 
EOSSP 


Problem 
Program Use 


UPSI 
Byte 


Job Name 


Highest 
Storage 
Address 
of the 
Partition 


End Address 
of Last Phase 
Fetched or 
Loaded 


Address of 
Uppermost 
Byte of Phase 
with Highest 
Ending Address 


Label 
Area 
Length 


XXXXXXXXX 


XX 


XX 


xxxxxxxx 


X 


XXXXXXXX 


xxxx 


XXXX 


XXXX 


XX 



2E 


30 


34 


35 


36 


37 


38 


39 


3A 


3B 


3C 


3E 


46 


48 


52 


53 


54 


55 


56 


57 


58 


59 


60 


62 


PIK 


End of 


Machine 


System 


Standard 


Dump 


Job 


Linkage 


Language 


Job 


Disk 


Address 




Virtual 


Confg. 


Confg. 


Language 


Log 


Control 


Control 


Translator 


Duration 


Address of 


of 




Storage 


Byte 


Byte 


Translator 


RELLDR 


Byte 


Byte 


Control 


Indicator 


Label 


FOCL 




Address 






I/O 
Options 


and ASCII 
Options 






Byte 


Byte 


Cylinder 




XX 


XXXX 


X 


X 


X 


X 


X 


X 


X 


X 


XX 


XX 















Job Control Switches 








40 


42 


44 


46 


48 


4A 


4C 


4E 


4F 


58 


5A 


5C 


64 


66 


68 


70 


72 


74 


76 


78 


79 


88 


90 


92 


Address 


Address 


Address 


Address 


Address 


Address 


Address 


Line 




LIOCS 


Address of 


ID Number 


of 


of 


of 


of 


of 


of 


of 


Count 




Comm. 


PIB Table 


of Last 


PUBTAB 


FAVP 


JIBTAB 


TEBTAB 


FICL 


NICL 


LUBTAB 


for 
SYSLST 


System date 


Bytes 




Checkpoint 
or DASDFP 
Indicator 


XX 


XX 


XX 


XX 


XX 


XX 


XX 


X 


XXXXXXXX 


XX 


XX 


XX 



5E 
94 


60 
96 


62 
98 


64 
100 


66 
102 


68 
104 


6A 
106 


6C 
108 


6E 
110 


Job Zone 

in 

Minutes 


Address of 
Disk 

Information 
Block (DIB) 


Reserved 


Address of 
PC Option 
Table less 
8 Bytes 


Address of 
IT Option 
Table 


Address of 
OC Option 
Table less 
8 bytes 


Key of 
Program 
with Timer 
Support 


Reserved 


Logical 

Transient 

Key 


XX 


XX 


XX 


XX 


XX 


XX 


XX 


XX 


XX 



70 


74 


78 


7C 


•7E 


80 


84 


86 


87 


112 


116 


120 


124 


126 


128 


132 


134 


135 


Address 


Address 


Address 


Address of 


Address of 


Address of 


Address of 


Op- 


System 


of 


of JA 


of 


PIB 


MICR DTF 


QTAM 


BG Comm. 


tion 


Configuration, 


SYSPARM 


Partition 


TOD-clock 


Extension 


Table 


Vector 


Region 


Indi- 


Byte 2, and 




Table 


Common 
Area 


(PIB2) 


(PDTABB) 


Table 




cator 


RMSR Open 
Flag Byte 


XXXX 


XXXX 


XXXX 


XX 


XX 


XXXX 


XX 


X 


X 



88 


8C 


8D 


8E 


8F 


97 


98 


9 p 


136 


140 


141 


142 


143 


151 


152 


159 


Reserved for 


Standard 


Temporary 


Disk 


Catalog 


Switch 


JCL 


81 byte 


compatibility 


Job Control 


Job Control 


Config- 


Procedure 


for 


Statement 


sysin 


reasons 


Options 


Options 


uration 


Name 


Catalog 
Procedure 


Name 
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tor 


XXXX 


X 


X 
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XXXXXXXX 


X 


xxxxxxx 


X 



Figure 4.2 Format and contents of any partition communications 

*The address of the communications region is in fixed location^X'14' — X'17' 
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PARTITION COMMUNICATION REGION ( Cont'd) 



Displacement 



(Dec) (Hex) 



8 
10 

12 

23 
24 
32 



36 
40 



44 
46 



48 
52 



00 



08 
OA 

OC 

17 
18 
20 



24 



28 



2C 
2E 



30 
34 



Meaning 



MM/DD/YY or DD/MM/YY either set permanently at IPL time or temporary by the job 

control date statement, or updated every time a GETIME macro is issued when 

time-of-day support is provided. 

Format controlled by BGCOMREG +53. 

(System Configuration Byte, data convention bit 0) 

Address of the problem program area. (PPBEG) 

Address of the beginning of the problem program area. The 16 lower order bits of 
Y (EOSSP) equals Y (PPBEG) 

User area. If seek separation option is specified, bytes 12 and 13 are used at IPL time 
for the address of the seek address block. 

Use program switch indicator. (UPSI byte) 

Job name set by the job control program from information found in the job statement. 

Address of the uppermost byte available to the problem program, that is either the 
address of the uppermost byte of the partition as determined during processing of the 
ALLOC or ALLOCR macro or statement, or the end address of the area specified by 
the SIZE parameter in the EXEC statement. 

Address of the uppermost byte of the last phase of the problem program fetched or 
loaded. Not filled in when the phase is in the SVA. 

Highest ending main-storage address of the last phase among all the phases having the 
same first four characters as the operand on the EXEC statement. For the phase 
$LNKEDT this field is not filled in. The address value may be incorrect if the program 
loads any of these phases above or below its link-edited origin address. If the EXEC 
statement has no operand, job control places in this location the highest ending 
address of all programs just link-edited. 

Length of the problem program label area. 

The low order byte identifies the partition (see Appendix B), and equals the 
displacement from the start of the PIB to the start of the PI B of the partition 
(without AP). The PI K from BGCOMREG changes during system operation and 
contains the PIK of the active partition (whichever one is active). The PIK in the 
FnCOMREG remains unchanged. 

End address of virtual storage. 

Machine Configuration Byte (Values set at supervisor generation time) 

Bit 0: Always set to indicate standard storage protect 
1: 1=Decimal feature (always set) 
2: 1=Floating point feature 

0=No floating point feature 
3: 1=Always set to indicate Physical transient overlap 
4: Always set to indicate standard timer feature 
5: 1=Channel switching device 

0=No channel switching device 
6: 1=Burst made on multiplex channel support 

0=No burst mode on multiplex channel support 
7: Indicates MCH/CCH in system. 



Figure 4.3. Key to Communication Region displacement, part 1 of 6 
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PARTITION COMMUNICATION REGION ( Cont'd) 



Displacement 




Maomn/i 


(Dec) 


(Hex) 


"■™ 9 


53 


35 


System Configuration byte 

BitO: 1=DDMMYY ln . L . • • ■_ „„,„, 
(Date convention bit set at generation time by STDJC) 

1 : 1=Two or more partitions 

0=One partition only supported 
2: 1=DASD file-protect supported 

0=No file-protect support for DASD 
3: 1=DASDSYSIN-SYSFIL 

0=No DASD SYSIN-SYSFIL 
4: 1 teleprocessing 

0=No teleprocessing 
5: 1=Two or more partitions 

0=One partition only supported 
6: 1=Asynchronous processing 

0=No asynchronous processing 
7: 1=Track Hold 

0=No Track Hold. 


54 


36 


This byte contains the standard language translator I/O options (set by STDJC macro). 

BitO: DECK option 1= yes, output object modules on SYSPCH 

1 : LIST option 1 = yes, output source module listings and diagnostics 

on SYSLST 
2: LIST X option 1= yes, output hexadecimal object module listings on 
SYSLST (compilers only) 






3 


SYM option 1= yes, output symbol tables on SYSLST/SYSPCH 






4 


XREF option 1= yes, output symbolic cross-reference list on SYSLST 






5 


ERRS option 1 = yes, output diagnostics on SYSLST (compilers only) 






6 


CHARSET option 1 = 48, input on SYSIPT is 48 or 60 character set 






7 


Reserved. 


55 


37 


This byte contains the standard supervisor options for abnormal EOJ, Relocating 
Loader and Control statement display and the indicator for the presence of the 
ASCII-EBCDIC and EBCDIC-ASCII translation tables. 

Bit 0: Always on 

1 : DUMP option 1 = yes, dump registers and storage on SYSLST 

2: 1 =partition in wait state, because volume is to be mounted 

3: LOG option 1= yes, list all control statements on SYSLST 

4: 1 =dummy device search in progress; do not enter ERP 

5: Not used 

6: Relocating Load 

option 1= yes. Relocating Loader supported 
7: ASM option 1= yes, ASCII supported. 


56 


38 


Job Control byte 

Bit 0: 1= Job accounting Interface (JA) is not supported 
0= Job accounting Interface (J A) is supported 

1: 1= Return to caller on LIOCS disk open failure 

0= Do not return to caller on LIOCS disk open failure 

2: 1= Job control input from SYSRDR 
0= Job control input from SYSLOG 
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PARTITION COMMUNICATION REGION ( Cont'd) 



Displacement 



(Dec) (Hex) 



56 



38 



57' 



39 



58 



3A 



59 



3B 



Job Control byte (. . . . Cont'd) 

Bit 3: 1= Job control output on SYSLOG 

0= Job control output not on SYSLOG 
4: 1= Cancel job 

0= Do not cancel job 
5: 1= Pause at end-of-job step 

0= No pause at end-of-job step 
6: 1= SYSLOG is not a console printer-keyboard or DOC 

0= SYSLOG is a console printer-keyboard or DOC 
7: 1= SYSLOG is assigned to the same device as SYSLST 
0= SYSLOG is not assigned to the same device as SYSLST. 

Linkage control byte 

BitO: 1= SYSLNK open for output 

0= SYSLNK not open for output 
1 : 1= Update of Second Level Directory and RAS loadlist in progress. 

(Interface between $MAINDIR and supervisor). 
2: 1= Allow EXEC 

0= Suppress EXEC 
3: 1= Catalog linkage editor output 

0= Do not catalog linkage editor output 
4: 1= Supervisor has been updated 

0= Supervisor has not been updated 
5: Reserved 
6: 1= Update of system CIL in progress. 

(Interface between &MAINDIR and supervisor) 

7: 1 = Check automatic condense limits and EOJ. 

(Interface between librarian and job control). 

Language processor control byte. This is a set of switches used to specify non-standard 
language translator options. The switches within the byte are controlled by job 
control OPTION statements and when set to 1 , override standard options. The 
format of this byte is identical to the standard option byte (displacement 54) with 
one exception: Bit 7 in this byte is used to indicate to LIOCS that the rewind and 
unload option has been specified. 

Job duration indicator byte 

Bit 0: 1= Job in progress 

0= Job not in progress 
1 : 1 = Dump on an abnormal end-of-job condition 

0= No dump on abnormal EOJ 
2: 1 = Pause at EOJ step 

0= No pause at EOJ 
3: 1= Job control output on SYSLST 

0= Output not on SYSLST 
4: 1= Job is being run out of sequence with a temporary assignment for SYSRDR 

0= Conditions for 1 -setting not met 
5: 1 = PCI L is being condensed 

0= PCI L is not being condensed 
6: 1= //DATE statement processed for current job 

0= No //DATE statement processed for current job 
7: 1= Batch command just issued 

0= Condition for 1 -setting did not occur. 
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PARTITION COMMUNICATION REGION ( Cont'd) 



Displacement 


Meaning 


(Dec) 


(Hex) 


60 


3C 


Binary disk address of the volume label area (label cylinder). 


62 
76 


3El 
4CJ 


Addresses of FOCL, PUB, FAVP, JIB, TEB, F ICL, NICL and LUB 
(See Figure 4.2) 


78 


4E 


Set to the value nn specified in the LINES= nn parameter of the STDJC macro. 


79 


4F 


The format of the system date contained within this field is determined by the I PL 
program from information supplied in the date convention bit (displacement 53). 
Bytes 85-87 contain the day count. 


88 


58 


Bytes reserved for use by LIOCS. Transient dump programs insert a key to indicate 
to the LIOCS end-of-volume routine, SSBCMT07, that it was called by a B-transient. 


90 


5A 


Address of the first part of the program information block (PIB) table. 


92 


5C 


ID number of the last checkpoint. Byte 92 is also the temporary indicator of file 
protected DASD. Bits 0-6 correspond to channels 0-6. A bit ON means DASDFP for 
that channel. Bit 7 indicates 2321 DASDFP support. Byte 93 is used at I PL time 
by PIOCS - Bit 0: 1 = 3330 file protection 
Bit 1:1= 3340 file protection 


94 


5E 


Job zone for Time of Day. If ZONE=EAST, value is positive; if ZONE=WEST, 
value is negative. 


96 


60 


Address of the disk information block (DIB) table for the partition. 


98 


62 


Reserved. 


100 


64 


Address for PC, IT, and OC option tables. 


104 


68 




106 
108 


6A 
6C 


Key of the program that has internal timer support. The key is the same as the 

PIK for the timer supported partition. If multiple partitions all have timer support it 

is initially X'0010' but may be changed to the PIK of another partition by the 

TIMER command. It is copied into all partition communications regions. If no 

partition has interval timer support, these bytes contain X'0000'. 

Reserved. 


110 


6E 


Logical Transient Key (LTK) contains the same value as the PIK (PID) (Displacement 

46) when the logical transient is requested. When the transient area is not in use, 

LTK is equal to zero. The SVC2 routine sets the LTK. (See Appendix B 

for a description of the LTK). 

The SVC1 1 routine resets the LTK, (only significant in BG communication reg.) 


112 


70 


Address of SYSPARM field. 


116 


74 


Address of Job Accounting partition table. 


120 


78 


Address of the Time of Day Clock common area. 


124 


7C 


Address of second part of program information block (PIB) table. 


126 


7E 


Address of PDTABB, table of DTF addresses for MICR support. 


128 


80 


Address of QTAM vector table (IJLQTTAD). 


132 


84 


Address of background communications region. 
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PARTITION COMMUNICATION REGION (. . . Cont'd) 



Displacement 



(Dec) (Hex) 



134 



135 



136 
140 



141 



142 



143 



86 



87 



8B 
8C 



8D 



8E 



8F 



Meaning 



Option Indicator byte 

Bit 0: Reserved 

1 : 1 = EU interface active 

0= EU interface inactive 
2: 1= Teleprocessing request 

0= No teleprocessing request 
3: 1 = Supervisor support for tape 

0= Supervisor does not support tape 
4: Reserved 
5: 1= RETAIN support generated 

0= RETAIN support not generated 
6: 1= Linkage to Channel En d Appendage Routine allowed 

0= Linkage to Channel End Appendage Routine not allowed 
7: 1= GETVIS function has been initiated 

0= GETVIS function has not been initiated. 



System Configuration byte 2 and RMSR Open Flag byte 

Bit 0: 1= PCI L supported 

0= PCI L not supported 
1 : TOD supported 
2: 1= PFIX macro supported 

0= PFIX macro not supported 
3: 1= Fetch $$OPEN by SJOBCTLJ 
4: 1= Fetch $$OPEN by SJOBCTLD 
5: 1= Fetch $$OPEN by SJOBCTLJ for WTM 
6: 1= QTAM supported 

0= QTAM not supported 
7: Reserved 



RMSR OPEN flags 



Pointer to Option table in SYSCOM. Reserved for compatibility reasons. 

Standard Job Control Option byte 
Bit 0: 1= EDECK Standard Option 
1: 1= ALIGN Standard Option 
Bit 2: 1 =ACANCEL standard 
3-7: Not used 

Temporary Job Control Option byte 

Bit 0: 1= EDECK Temporary Option 
1:1= ALIGN Temporary Option. 
Bit 2: 1 =ACANCEL temporary 
3-7: Not used 

Disk Configuration byte 
Bit 0-4: Not used 

5: 1 = 3340 supported 
= 3340 not supported 

6: 1= 3330 supported 

0= 3330 not supported 
7: Always 1 ; indicates 231 1 and 2314/2319 supported. 

Catalogued Procedure Name. 
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PARTITION COMMUNICATION REGION (. 



Cont'd) 



Displacement 


Meaning 


(Dec) 


(Hex) 


151 


97 


Interface byte for Catalogued Procedures 

Bit 0: 1= Procedure being executed 
1 : 1 = Overwrite processing 
2: 1= Procedure with data 
3: 1 = Overwrite request for Job Control 
4: 1= Insert request for Job Control 
5: 1= Procedure end 
6: 1= SYS LOG procedure 
7: 1= Overwrite request for Supervisor. 


152 


98 


JCL statement name for Catalogued Procedure. 


159 


9F 


SYSIN 81 bytes indicator 

Bit 0: 1= Permanent 81 bytes on SYSRDR 
1:1= Permanent 81 bytes on SYSIPT 
2: 1= Temporary 81 bytes on SYSRDR 
3: 1= Temporary 81 bytes on SYSIPT 
4-6: Not used 
7: 1=Allow/&for MAINTCATALS. 
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System communication Region (SYSCOM) 

This table is located in the supervisor, immediately after the background partition 
communication region. It contains partition-independent pointers and addresses of 
tables used by the system control program (SCP). The contents of SYSCOM is 
listed in Figure 4.4 parts 1 and 2, displacements are given in hexadecimal from the 
first byte of SYSCOM 



Locating SYSCOM 

Bytes X'80 - 83' of low address storage contain the address of SYSCOM. 

Displacement 



Hex 


00 


04 


08 


OA 


0C 


10 


14 


18 


Dec. 


00 


04 


08 


10 


12 


16 


20 


24 




Address 


Address 


Address 


Address 


Address 


Address 


Address 


Address 




of Error 


of 


of 


of 


of 


of 


of I/O 


of External 




Block 


Attention 


Operator 


Operator 


SYSRES 


Fetch 


Interrupt 


Interrupt 






Exit 


Option 
Cancel 
Exit 


Request 

Cancel 

Exit 


PUB 


Routine 


Routine 


Routine 



Hex 


1C 


20 


24 


25 


28 


2A 


2C 


2E 


Dec 


28 


32 


36 


37 


40 


42 


44 


46 




Address 


Address 


Free 


Address 


Number 


Length 


Number 


Not Used 




of 


of First 


List 


of 


of 


of One 


of 






Logical 


Byte of 


Poi 


Channel 


Channel 


Error 


Partitions 






Transient 


Problem 


nter 


Queue 


Queue 


Queue 








Area 


Program 
Area 






Entries 


Entry 







Hex 


30 


34 


38 


3C 


40 


44 


46 


48 


Dec 


48 


52 


56 


60 


64 


68 


70 


72 




Address 


Address 


Address 


Address 


Flags and 


System 


Address 


Address 




of 


of 


of 


of 


Switched 


Task 


of 


of 




Channel 


CRT 


Seek 


Channel 




Selection 


Task 


PD Area 




Buckets 


Table 


Address 

Block 

Table 


Control 
Table 


expansions) 


Control 
Field 


Selection 





Hex 


4C 


50 


54 


58 


5A 


5C 


60 


Dec 


76 


80 


84 


88 


90 


92 


96 




Address 


Address 


Address 


Key of 


Key of 


Address 


Reserved 




of Track 


of Timer 


of AB 


Task 


Task 


of 






Hold 


Request 


Table 


Owning 


Running 


POWER 






Table 


Table 




LTA 




Table 





Hex 


64 


68 


6C 


70 


74 


•78 


7C 


80 




Dec 


100 


104 


108 


112 


116 


120 


124 


128 






Address 


Address 


Address 


Address 


Address 


Address 


Address of 


Base 






of 


of 


of 


of 


of 


of PUB 


Job 


Address 






RF 


EU ECB 


OLTEP 


RAS 


ASCII 


Owner- 


Account- 


of Page 






Table 


Table 


Bucket 


Linkage 


Translate 


ship 


ing 


Management 












Area 


Table 


Table 


Common 
Table 


Routine 




Hex 


84 


88 


8C 


90 


94 


98 


9C 


A0 


A1 


Dec 


132 


136 


140 


144 


148 


152 


156 


160 


161 




Base 


Address 


Address 


Address 


Address 


Address 


Address 


Align- 


Pointer 




Address 


of 


of Line 


of 


of PTA 


of First 


of Task 


ment 


to 




of Channel 


SDAID 


Mode 


VSAM 




System 


Block 


Byte 


RAS 




Program 


Save 


Table 


Comm 




Task 


of 




Task 




Translation 


Area 




Area 




Block 


active 




Block 




Routine 












System 
Task 
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Hex 


A2 


A3 


A4 


A5 


A6 


A7 


BO 


B4 


B8 


Dec 


162 


163 


164 


165 


166 


167 


176 


180 


184 




Pointer 


Pointer 


Pointer 


Pointer 


Pointer to 


Reserved 


Not 


Address 


Not 




to 


to 


to CRT 


to ERP 


PAGEIN 


9 X'OO' 


Used 


of 


Used 




PMGR 


SUPVR 


Task 


Task 


Task block 






MVCFLD 






Task 


Task 


Block 


Block 














Block 


Block 

















COMMUNICATION 
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Hex 


BC 


BE 


CO 


CB 


CC 


CE 


DO 


D4 


D8 


Dec 


188 


190 


192 


203 


204 


206 


208 


212 


216 




Not 


Not 


Reposi- 


Number of 


Length 


Number 


Address 


Address 


Address 




Used 


Used 


tioning 


Error 


of PUB 


of 


of 


of Page 


of Page 








information 


Queue 


Table 


Active 


Segment 


Frame 


Frame 








for MFCM 


Entries 


in Bytes 


Partitions 


Table 


Table 


Table 








ERP 












Extension 



Hex 
Dec 



DC 


E0 


E4 


E8 


EC 


F0 


F4 


F5 


F8 


220 


224 


228 


232 


236 


240 


244 


245 


248 


Address 


Address 


Reserved 


Address 


Address 


, Address of 


SVA 


Address 


Address of 


of 


of DPD 




of 


of End 


Fetch 


Flag 


of SVA 


System 


Boundary 


Table 




VIRTAD 


of Real 


table 


(See 




GETVISarea 


Box 






Routine 


Storage 
(Fullword) 








. 



Figure 4.4 Format and contents of SYSCOM, part 2 of 2 



Dec 


Hex 


Description 


64 


40 


Reserved for RMS support on the Models 115 and 125 








X'80' 


RMSR for channel attached devices, tapes and TP dev 


ces 






X'40' 


Full RMS support (MCAR/CCH and RMSR) 








X'20' 


MCAR/CCH support 




65 


41 


X'80' 
X'40' 
X'20' 
X'10' 
X'08' 
X'04' 
X'02' 

x'or 


Initial selection of ErP 

Reserved 

Timer interrupt pending 

MICR Stacker-select active 

Invalid address during fetch 

SIO routine entered after interrupt 

Reserved 

IPL in progress 




66 


42 


X'80' 
X'40' 
X'20' 
X'10' 
X'08' 
X'04' 
X'02' 

x'or 


Initial RAS request 

RAS WAIT request outstanding 

RAS IPL in progress 

Reserved 

POWER supported 

POWER initialized 

GETREAL for SDAID in progress 

Fetch for system task in progress (used by PDAID's) 




67 


43 


Reserved 







LAYOUT OF SYSTEM TASK SELECTION CONTROL FIELD 



244 F4 


SVA Flag 




X'80' Do not test for warm start copy of SVA 




X'40' SDL active 




X'20' No 'Set SVA' or 'Set SDL. allowed 




X'10' Build of SDL in progress 




X'08' SDL overflow 




X'04 7 ! 




X'02'\ Reserved 




x'orj 



Dec 


Hex 


Description 


68 


44 


Always zero 


69 


45 


SELECT byte: 

X'OO' No system task active 

X'01' RAS active 

X'02' PMGR active 

X'03' SUPVR active 

X'04' CRT active 

X'05' ERP active 

X'06' PAGEIN active 



Figure 4.5 



SYSCOM Expansion flag bytes. 
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I/O TABLES AND 
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The I/O tables and information blocks in the supervisor establish the interface 
between a specific task and the hardware channels. For example, for every logical 
unit name (SYSXXX) used, there must be a LUB (Logical Unit Block) entry. For 
every physical device used by the system, there must be a PUB (Physical Unit 
Block) entry. Then, when an I/O request occurs, an entry is made, via LUB and 
PUB, in the CHANQ (Channel Queue). An I/O request queued in the CHANQ 
contains an address that points to the CCB (Command Control Block) that 
contains the address of the channel program. 

During the I/O device operation, entries are made in the ERRQ (Error Queue) in 
the Error Recovery Block, if a hardware failure occurs on the device. 

Figure 4.6 (opposite) is an overall picture that illustrates the connections between 
the tables, (It does not represent their actual position, size, or relation as they are 
stored or printed in a dump output.) The initial pointers for all the tables and 
blocks are stored either in SYSCOM or in the active partition comreg. 

Where a connection exists between tables, for example, the PUB and the CHANQ, 
pointers are contained in the table entries concerned. For example, the Figure 
shows a one-byte pointer in the PUB entry number 00 that relates this PUB entry 
to CHANQ entry number 00. 

Figures 4.7 through 4.1 6 show the format of the tables and describe their contents. 

A formatted stand-alone dump output prints the contents of the tables in a more 
readily understood format, and an example of such an output is shown in appendix 
G. The stand-alone dump program is described in Section 2 -A of this manual. 
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The LUB table 

This table is built up during system generation by the IOTAB supervisor generation 
macro, according to the BGPGR and FnPGR parameters (where n is the partition 
number). The table has one entry for each logical unit required for the system. 
Each entry is two bytes long and entries are grouped into two classes: 

• System LUBs 

• Programmer LUBs 

There are always 14 system LUBs for each partition on the system. 

By examining the contents of this table you can see the logical units that: 

• Are unassigned or assigned (and, if assigned, to which entry in the PUB table) 

• Have a temporary assignment or an alternate assignment, or indicate that a 
DASD file is opened. 

How to locate: 

Bytes X'4C— X'4D' in the partition communication regions contain the address 
of the first entry in this table. Label LUBTAB in the supervisor listing identifies 
the address of the first byte of this table. 

The number of LUB entries for system logical units in the BG System LUB and the 
number of LUB entries for programmer logical units in each programmer LUB is 
stored in the NICL information block. 

NICL, (Number in Class List) 

Byte of this information block contains the number of System LUB entries (for 
DOS/VS, always 14, X'OE'). Byte 1 contains the number of programmer LUBs for 
the BG partition, and the remaining bytes contain the number of programmer LUBs 
for each foreground partition in the system (one byte per partition). 
The total number of bytes in the NICL is equal to the number of partitions in the 
system plus one. 

How to locate 

Bytes X'4A' — X'4B' of the partition comregs contain the address of the first entry 

in this information block. Label NICL in the supervisor listing identifies the 

address of the first byte of this information block. 

A pointer to the first entry in the LUB table and a pointer to the first LUB entry 

for the programmer LUBs for each partition is stored in the FICL information 

block. 

FICL, (First In Class List) 

Each byte of this information block points as a displacement index to the 
beginning of a LUB sector. 

Byte to the first LUB entry, and the remaining bytes to the first LUB entries for 
each programmer LUB of each partition. The total number of bytes in the FICL is 
equal to the number of partitions in the system plus one. 

How to locate: 

Bytes X'48' - X'49' of the partition comregs contain the address of the first entry 
in this information block. Label FICL in the supervisor listing identifies the 
address of the first byte of this information block. 

Figure 4.7 (opposite) shows the format and contents of the LUB table, and expands 
one entry in order to explain its contents. The figure also shows the relationship 
between the LUB, NICL, and FICL. 



4.46 Debugging for Programmers, part 2. 



Section 4, Chapter 3 



Number in 
Class List 
(NICL) 



LUBTAB 



First in 
Class List 
(FICL) 



SYS 






BG 

System LUBs 


■^ 






-SYS 


l» 




BG 






BG 

Programmer LUBs 






F4 








I—** 






- F3 

- F2 

r F1 


F3 


F4 

System LUBs 






F2 


F1 


F4 

Programmer LUBs 
















F3 

System LUBs 






F3 

Programmer LUBs 


















F2 

System LUBs 






F2 

Programmer LUBs 














F1 

System LUBs 






F1 

Programmer LUBs 













System Lubs 



LUB Table for any ; 
Partition 



Programmer Lubs 



SYSRDR 
SYSIPT 
SYSPCH 
SYSLST 
SYSLOG 
SYSLNK 
SYSRES 
SYSSLB 
SYSRLB 
1) SYSUSE 
SYSREC 
SYSCLB 
SYSVIS 
SYSCAT 
SYSOOO 
SYS001 
SYS002 
SYS003 
SYS004 

\l) SYSnnn 



I/O TABLES AND 
INFORMATION BLOCKS 



00 000000 - Points to first PUB and PUBOWNER 
1 -Points to second PUB and PUBOWNER 
10 -Points to third PUB and PUBOWNER 



11111110— Ignore, assigned ignore 

11111111— Null Pointer, the LUB is unassigned 
When a logical unit is assigned, the system inserts a pointer 
to the PUB for the physical device specified. 



ByteO 


Byte 1 


PUB Pointer 


JIB Pointer 



1 ) SYSUSE may be called SYSCTL in error recovery messages. 

2) Since there are 14 system LUBs for each partition, 

the maximum number of Programmer LUBs is as follows: 

When number of partitions (NPARTS) = 1:241 

When number of partitions (NPARTS) = 2:227 

When number of partitions (NPARTS) =3:213 

When number of partitions (NPARTS) = 4:199 

When number of partitions (NPARTS) = 5:185 



JIB Index (Multiply by 4 = Displacement into JIB Table) or 
X'FF' = Null Pointer, no JIB for this LUB. 

A LUB has a JIB pointer in three situations: 

1 . The logical unit is temporarily assigned. 

2. The logical unit assignment is alternate (ALT). 

3. A DASD file (except a system I/O file on disk) is 
opened (DASD file protect only). 



Figure 4.7. The LUB table. 

The figure illustrates the format and contents of one entry and shows its relationship to the 
NICL and FICL information blocks. 
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The PUB table 

This table is built up during system generation by the IOTAB supervisor genera- 
tion macro and each DVCGEN macro fills one PUB entry in the PUB table. 



By examining the contents of this table you can see both the physical address of 
each I/O device attached to the system and which devices are queued in the 
CHANQ. In conjunction with the contents of the LUB and JIB, you can ascertain 
the status of an I/O request for any logical unit. 

The number of bytes in the PUB table (its size) is determined during system 
generation, although the operator can ADD or DELETE I/O devices during IPL. 
The PUB is divided into seven parts, each part containing the I/O devices attached 
to one of the seven channels. The first entry in the PUB belongs to the I/O device 
with the highest priority on channel 0. A pointer to the first PUB entry for each 
channel on the system is stored in the FOCL information block. 

How to locate: 

Bytes X'40' — X'41' of the partition communication regions contain the address 
of the first entry in this table. Label PUBTAB in the supervisor listing identifies 
the address of the first byte of this table. 

The figure below shows the format and describes the contents of an entry in the 
PUB. Figure 4.9 (opposite) details a PUB entry to bit level. 



PUBTAB 



Channel 
PUBs 



Channel 1 
PUBs 



Job Control Flags 
Channel Scheduler Flags 

Device Type 

TEB Pointer 
Retry Counter 
Unit 



n 



Channel 6 
PUBs 



r FF 



PUB-table 
delimiter 



PUBEND 






Channel Queue Pointer 
Channel 

Device Characteristic Code 
or SAB Pointer 




Figure 4.8. 



FOCL (First on Channel List) 



"fe# 



Byte of this information block points as a displacement index to the first PUB 
entry for the I/O device attached to channel 0, and byte 1 points to the first 
PUB entry for channel 1 . The remaining five bytes point to the first entries in 
the PUB belonging to channels 2 to 6. X'FF' indicates that the associated channel is 
not supported on the system. 

How to Locate: 

Bytes X'3E' - X'3F' of the partition communication regions contain the address 
of the first entry in this information block. Label FOCL in the supervisor listing 
identifies the address of the first byte of this information block. 
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Byte 
Byte 1 
Byte 2 
Byte 3 

Byte 4: 
Byte 5: 



Channel number. (Hex 0-6, FF = NULL) 

I/O device unit number 

Hex 0, 1 , 2, points to the first channel queue entry for this device. 

If device is a 2495 Tape Cartridge Reader and TEBs are specified, this 

byte is a TEB pointer (Hex 1, 2, 3, ). Otherwise, this byte is a ERP retry counter. 

Device type code. See Figure 4.10, parts 1 through 3. 

SS of the MODE= parameter in the DVCGEN macro for tape unit (See Section 2). 
For the Models 1 15 and 125 ICA line, this byte contains the displacement index of 
the entry in the Line Mode Table (LMT). The address of the LMT is contained 
in bytes X'8C - X'8F' of SYSCOM. 

For DASD with seek separation, this byte is used as the SAB Pointer. 
With Track Hold but not seek separation supported, this byte contains 
a pointer to the Track Hold Table entry or X'FF' (with both SKSEP and 
TRKHLD specified, the track hold pointer is found in the SAB entry). 

For MICR type devices, this byte indicates which external interrupt line 
is in use. 

For a 3705 Communications Controller, this byte contains the type number 
of the Channel Adapter. 

ForMFCMor MFCU 



Bit 0: 
1: 



7: 



1= Repositioning required 
0= SYSPCH temporarily assigned to hopper 1 
1= SYSPCH temporarily assigned to hopper 2 
0= SYSIPT temporarily assigned to hopper 1 
1= SYSIPT temporarily assigned to hopper 2 
0= SYSRDR temporarily assigned to hopper 1 
1= SYSRDR temporarily assigned to hopper 2 
0= SYSPCH permanently assigned to hopper 1 
1= SYSPCH permanently assigned to hopper 2 
0= SYSIPT permanently assigned to hopper 1 
1= SYSIPT permanently assigned to hopper 2 
0= SYSRDR permanently assigned to hopper 1 
1= SYSRDR permanently assigned to hopper 2. 



Byte 6: Channel Scheduler Flags 

Bit 0: 1= Device busy 

1 : 1= Switchable device 

2: 1= EOJ for SYSRDR or SYSIPT 

3: 1=1/0 error queued for recovery 

4: 1= Operator intervention required 

5: 1= Device End posting required 

6: 1= Burst mode or overrunnable device on byte MPX channel 

7: 1= 7-track tape unit. 

Byte 7: Job Control Flags 

Bit 0-4: Standard MODE assignment for 7-track tape (all ones 
if not tape, all zeros if device is down) 

Bit 5: 1 = DASD device with disconnect command chaining feature 

Bit 6-7: B'11' (both on)= Headqueue in progress 
B'01' = Headqueue requested. 



Figure 4.9. 



Note: A null is generated for each device to be supported by the supervisor. Standard physical 
unit assignments are made to the PUB table at supervisor generation time. 
PUBs are ordered by channel and priority within a channel. 

An entry in the PUB Ownership Table is associated with each entry in the PUB Table, 
if the supervisor has been generated to support multiprogramming. 

Explanation of the contents of an entry in the PUB table 
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Card 
Code 


Actual IBM Device 


Device- 
Type X'nn' 


Device Type 


2400T9 
2400T7 
341 0T9 
341 0T7 
3420T9 
3420T7 


9-track Magnetic Tape 

Tape units 

7-track Magnetic 

Tape units 

9-track 3410 Magnetic 

Tape units 

7-track 3410 Magnetic 

Tape units 

9-track 3420 Magnetic 

Tape units 

7-track 3420 Magnetic 

Tape units 


50 
50 
53 
53 
52 
52 


Magnetic Tape devices 


2495TC 


2495 Tape Cartridge 
Reader 


51 


Tape Cartridge Reader 


1442N1 
2520 B1 
2560 

2596 
3525RP 

5425 


1442N1 Card Read Punch 

2520B1 Card Read Punch 

2560 Multifunction Card 

machine 

2596 Card Read Punch 

3525 Card Punch (with 

optional read feature) 

5425 Multifunction Card 
Unit 


30 
31 
33 

30 
32 

34 


Card Read Punches 


2501 
2540R 
3504 
3505 


2501 Card Reader 
2540 Card Reader 

3504 Card Reader 

3505 Card Reader 


10 
11 
12 
12 


Card Readers 


1540P 

2520B2 

1442N2 

2520B3 

3525P 


2540 Card Punch 
2520B2 Card Punch 
1442IM2 Card Punch 
2520B3 Card Punch 
3525 Card Punch 


21 
20 
22 
20 
23 


Card Punches 


1403 
1403U 

1443 
2260(local) 

3203 

3211 
3277 
(local 3270) 

327 7 B 
(local 3270) 

5203 
52030 


1403 Printer 
1403 Printer with UCS 
feature 
1443 Printer 
1053 Printer with 2848 
Control Unit. MODE 
operand must be entered 
as X'01' 
3203 Printer 
3211 Printer 

3284 or 3286 Printer with 
3272 Control Unit. MODE 
operand must be entered 
asX'01' 

3284 or 3286 Printer with 
3272 Control Unit, attached 
in burst mode to a multi- 
plexer channel. MODE 
operand must be entered 
asX'01' 
5203 Printer 
5203 Printer with 
UCS feature 


40 
42 

41 
CO 

4A 
43 
BO 

BO 

4C 
4D 


Printers 
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Card 
Code 


Actual IBM Device 


Device - 
Type X'nn' 


Device Type 


1050A 


3210, 3215 Console 
Printer Keyboards 


00 


Printer-Keyboards 


125D 
125DP 


Models 115 and 125 Integrated 

Video Display Unit 

Models 115 and 125 Integrated 

Video Display Unit 

with 5213 Console Printer 

attached 


B2 
B2 


Video Display Unit 


UNSP 
UNSPB 


Unsupported device 
Unsupported device 


FF 
FF 


Unsupported. No burst mode 
on multiplexer channel 
Unsupported with burst 
mode on multiplexer 
channel 


2311 
2314 

2314 
2321 
3330 

3340 

3340 

3340 


231 1 Disk Storage device 

2314 Direct Access 

Storage Facility 

2319 Disk Storage Facility 

2321 Data Cell Drive 

3330-1,3330-2, or 333-1 

Disk Storage 

3340 Disk Storage 

(general) 

3340 Disk Storage 

with 3348 Mod 35 

3340 Disk Storage 

with 3348 Mod 70 


60 
62 

62 
61 
63 

68 

69 
6A 


DASD 


1419 

1419 

1419 

1419P 

1419S 


1255 Magnetic Character 

Reader 

1259 Magnetic Character 

Reader 

1419 Magnetic Character 

Reader 

1419 Dual Address Adapter 

Primary Control Unit 

1419 Dual Address Adapter 

Secondary Contr. Unit 


72 
72 
72 
73 
74 


MICR- Magnetic Ink 
Character Recognition 
devices 


2701 

A 
2702 I 

D 
2703 

2703 
2703 


2701/2715 Data Adapter 
Unit 

2702 Transmission Control 
Unit 

2703 Transmission Control 
Unit 

Integrated Communications 
Adapter (Models 125 and 135) 
3705 Communications 
Controller in Emulation 
Mode 


DO 
D1 

D2 

D2 
D2 


Teleprocessing lines 

A= SADO comm'd 

r. o a r^.. . . when 

B= SAD1 comm d 

r> cam .j enabling 

C= SAD2 comm d , .. 

r-v oa^o . . the line 

D= SAD3 comm d 


2955 


2955 Data Adapter Unit 


D7 


Data Link for RETAIN 


1017 
2671 


1017 Paper Tape Reader 
with 2826 Control Unit 
2671 Paper Tape Reader 


78 
70 


Paper Tape Readers 
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Card 
Code 


Actual IBM Device 


Device- 
Type X'nn' 


Device Type 


1018 


1018 Paper Tape Punch 
with 2826 Control Unit 


79 


Paper Tape Punch 


1419 
1419P 


1270 Optical Reader/ 

Sorter 

1275 Optical Reader/ 

Sorter 


72 
73 


Optical Readers 


1287 
1288 
3881 
3886 

3540 


1287 Optical Reader 

1 288 Optical Page Reader 
*3881 Optical Mark Reader 

3886 Optical Character 

Reader 

3540 Diskette I/O unit 


77 
77 
11 
7C 


Optical Readers 
DISKETTE 


2260 
3277 
(local 3270) 

3277 B 
(local 3270) 


2260 Display Station 
3277 Display Station; 
MODE operand need not 
be entered 

3277 Display Station; 
attached in burst mode to 
a multiplexer channel. 
MODE operand need not 
be entered 


CO 
B0 

B0 


Display Stations 


7770 


7770 Audio Response Unit 


D3 


Audio Response unit 



*Note: The logical unit name SYSIN cannot be assigned to a 3881 
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PUBOWNER (PUB ownership) 

An area in the supervisor is always reserved for this table. The number of entires 
is equal to the number of entries in the PUB, and each entry is two bytes long. 



I/O TABLES AND 
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By examining the contents of this table in conjunction with the associated entry in 
the PUB, you can identify the partition using a particular I/O device, for example, 
when conflicting assignments are thought to be the cause of a system malfunction. 



How to locate: 

Bytes X'78' - X'7B' of SYSCOM contain the address of the first entry in this 
table. Label PUBOWNER in the supervisor listing identifies the address of the 
first byte of this table. The Figure below shows the format and describes the 
contents of an entry in the PUBOWNER. 



PUBOWNER 






1 



[^ 

Byte 0: 


Bit Reserved 

1 1 = waiting for volume to be mounted 
2-7 Reserved 




Byte 1 : 


Identifies the partition that owns the PUB according to following table: 






Flag 


Partition owning PUB if number of partition is: 






2 


3 


4 


5 


X'01' 


BG 


BG 


BG 


BG 






X'02' 


F1 


F2 


F3 


F4 










X'04' 




F1 


F2 


F3 










X'08' 






F1 


F2 










X'10' 








F1 













Notes: The number of entries in the PUB Ownership table is equal to the 

number of entries in the PUB table. Associated with each PUB entry 
is an entry in the PUB Ownership table. 



Figure 4. 1 1 Contents of an entry in the PUBOWNER. 

The relationship between the PUB, the PUBOWNER, and the FOCL is shown in Figure 4.6 
at the beginning of this Chapter. 
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The JIB (Job Information Block) 

An area in the supervisor is reserved for this information block during system 
generation by the JIB parameter of the IOTAB macro. This information block 
records any changes to the standard or permanent assignments made by the 
// ASSGN job control statement. Extent information is also recorded in the JIB 
when the supervisor supports the DASDFP feature. 

By examining the contents of an entry in the JIB and its associated LUB, PUB, 
and PUBOWNER entries you can identify the logical units that are temporarily 
assigned, the address of the I/O device, and the partition using the device. Useful 
information can also be obtained from the JIB about DASD extents (DASDFP only), 
for example, when it is not certain why the message INVALID SEEK ADDRESS 
is printed during the execution of a particular job. 



How to locate: 

Bytes X'44' - X'45' of the partition communication regions contain the address of 
the first entry in this information block. Label JIBTAB in the supervisor listing 
identifies the address of the first byte of this information block. 

Entries in the JIB are made: 

• when a temporary assignment is made 

• by alternate tape assignments 

• by DASD extent information (when the file protect feature is supported 
by the supervisor.) 

The next available JIB entry is recorded in the FAVP. 



FAVP (First Available Pointer) 

This is a one-byte pointer to the next available JIB entry. It contains a hexadecimal 
displacement from the first entry in the JIB. If it contains X'FF', no more entries 
in the JIB are available. 

How to locate: 

Bytes X'42' - X'43' of the partition communication regions contain the address 
of this pointer. Label FAVP in the supervisor listing identifies the address of this 
one-byte pointer. 

Figure 4.12 (opposite) illustrates the format and contents of a JIB entry. Its 
relationship to the LUB and PUB is indicated in Figure 4.6. 
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1 


2 


3 



/ 



\ 



/ 



\ 



\ 



Number of entries (length of JIB table) 
is determined at supervisor generation 
time 



Note 1: Only when file-protect on DASD. 

Note 2: Two JIB's are required for a 232 1/3330/3340 extent; one for lower 

limit and one for upper limit. The lower limit defining JIB must 

be chained to the upper limit defining JIB. 

For 2321, byte 1 of this JIB contains the subcell number times 

10 plus the strip number in binary. 









Byte(s) 


Description 


0-1 (Contents 
depends on the bit 
setting in byte 2) 


Bit setting 
Byte 2 


Contents 


Bit 0= 1 


LUB entry of stored standard assignment. 




Stored standarc 


(PUB and JIB pointer) 




assignment 




Bit 1= 1 


Byte 0: PUB pointer 




Alternate 


Byte 1 : X'00' 




assignment 




Bit 2= 1 


Byte 0: Cylinder lower limit 




2311/2314/ 


Byte 1 : Cylinder upper limit 




2319 Extent 


See Note 1 


Bit 3= 1 


For 2321 : 




2321/3330/3340 


Lower limit (Cell or combined 




Extent 


subcell and strip), or 

Upper limit (Cell or combined 
subcell and strip) 

For 3330/ Cylinder lower limit, or 

3340: Cylinder upper limit (One cylinder 
number of the 3330/3340 
uses two bytes) 

See Notes 1 and 2 


2 


Meaning if bit = 1 : 




Bit 0: Stored standard assignment 




Bit 1 : Alternate assignment 




Bit 2: 2311/2314/2319 extent 




Bit 3: 2321/3330/3340 extent 




Bit 4: The alternate assignment indicated in bit 1 is permanent. 




This bit is also on when one of the extent indicators 




(bit 2 and bit 3) is on. 




Bit 5: Catalogued procedures processing 




Bit 6/7: Reserved. 


3 


Chain byte 




Contains the displacement index of the next JIB. 




X'FF' defines the end of the chain. 



Figure 4.1 2 Explanation of the contents of an entry in the JIB. 



Debugging for Programmers, part 2. 4.55 



Section 4, Chapter 3 

I/O TABLES AND 
INFORMATION BLOCKS 



CHANQ (Channel Queue) 

The area in the supervisor reserved for this table is determined during system 
generation by the CHANQ parameter of the IOTAB macro. 

This table is used by the supervisor to schedule I/O operations. An entry is made 
in the channel queue whenever a request is made for an I/O operation, and the 
entry remains in the queue until the operation is completed. Thus, at any point 
in time, the queue will consist of entries for I/O operations in progress and I/O 
operations waiting for initiation. Whenever an I/O event completes, the queue is 
examined to see if an operation is waiting for the device, and if so, .the operation 
is initiated. 

Each entry made in this table occupies an eight-byte field. Entries are pointed to 
by a CHANQ POINTER contained in byte 2 of any PUB entry owning a device 
waiting for an I/O operation to complete. 

By examining the contents of this table together with the contents of the PUB 
table you can determine the following: 

• Whether a particular I/O device is waiting for an I/O operation to be completed. 

• The reason for an uncompleted operation. 

• How many I/O requests have been made for a particular device (by looking at 
the CHAIN byte). 

• The CCB (Command Control Block) address and, therefore, the channel 
program and I/O area used by a particular device. (The CCB and channel 
program are described in Chapter 5 in this Section.) 

• The identity of the task that requests an I/O operation for a particular 
device. 

• Whether the channel queue is completely occupied (probably causing a soft 
wait state). 



How to locate: 

Bytes X'25' - X'27' of SYSCOM contain the address of the first entry in this table. 
Label CHANQ in the supervisor listing identifies the address of the first byte of 
this table. 

The number of channel queue entries occupied at any given point in time depends 
on the I/O activity in the system. A one-byte pointer (FLPTR) points to the next 
eight-byte field in this table that is free for use. 



FLPTR (Free List Pointer) 

This one-byte pointer contains the hex displacement from the beginning of the 
channel queue table to the next available CHANQ entry. When the channel queue 
is full, it contains X'FF'. 



How to locate: 

Byte X'24' of SYSCOM contains the address of this information byte. Label 
FLPTR in the supervisor listing identifies the address of the first byte of this 
information byte. 

For a detailed description of the operation of the CHANQ and FLPTR refer to the 
DOS I VS Supervisor Logic manual. 

Figure 4.13 (opposite) shows the format and describes the contents of the CHANQ 
table, and Figure 4.6 illustrates the relationship between the PUB, CHANQ, and 
FLPTR. 
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CHANQ 



FLPTR 



PUB * 
byte 2 
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Task requestor Identification 
LUB Displacement 

LUB Identification 

Requestor Identification 



P 



Chain byte 
CCB address 



/ 



/ 



/ 



/ 



\ 



The length of the queue is determined 
at supervisor generation time 



\ 



/ 



/ 



Byte 4: 



Byte 5: 



Byte 6: 



Byte 7: 



\ 



\ 



\ 



Byte 0: Contains the displacement within the channel queue of the next entry in the free 

list or in the list for a specific device, or X'FF' when it is the last entry in the free 
list or a device list. 

Bytes 1 -3: Contains the CCB address for the specified device. 



Contains a code identifying the task making the I/O request. The one-byte entry 
indicates to which task the CCB belongs, and is in the form X'nk' where: 
n = user storage protection key. (Attention or system task = 0, BG task = 1 , 
FG tasks = 2-5 depending on the number of partitions.) 
k = for Attention and all user tasks. 
1 for RAS 



2forPMGR 
3forSUPVR 

4 for CRT 

5 for ERP 

6 for PAGEIN 



nK = FF for any unused channel queue entries. 



If the I/O request is from a subtask, this byte does not identify the subtask, but 
the partition. See Appendix B for an explanation of the REQID. 

Contains pointer (displacement index) to the entire LUB table identifying the 
logical unit making the I/O request. This is doubled to get the actual displacement 
into the full LUB table. 

Contains X'FF' if the LUB is a programmer class, or the displacement within the 
partition LUB if it is a system class. 
(Not used by a non-MPS Supervisior.) 

Contains the displacement within the PIB table of the PIB of the task requesting 

I/O, or X'FF' when the channel queue entry is in the free list. 

(Not used by a non-MPS Supervisor.) See Appendix B for an explanation of 

theTKREQID. 



*Notes: FLPTR: The free list pointer contains the displacement within the channel 
queue of the first entry in the free list of X'FF' when the channel queue is 
full. Byte X' 24' of the System Communication Region (SYSCOM) contains 
the address of the Free List Pointer. 
Label FLPTR identifies the location of the pointer (1 byte). 

PUB byte 2: The PUB channel queue pointer contains the displacement 
within the channel queue of the first entry for a specific device. 



Figure 4. 1 3. Explanation of the contents of an entry in CHANQ. 
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Channel Control Table. 

This table contains a code identifying the channel types attached to the system. 
There is one entry for each channel attached, and each entry is two bytes long. 

No system generation macro is required to reserve an area in the supervisor for this 
table; information is entered into it by the STORE CHANNEL ID instruction during 
IPL. 



How to locate: 

Bytes X'3C - X'3F' of SYSCOM contain the address of the first entry in this 
table. Label CHNTAB in the supervisor listing identifies the address of the first byte 
of this table. 

Figure 4. 1 4 (opposite) lists the meaning of the code contained in byte of this 
table; byte 1 is always zero. 



Channel bucket 

This information block is always generated in a supervisor. Each channel attached 
to the system owns a 24-byte field in this information block, which records the 
contents of the I/O registers (general registers 1,2,3, and 4) and a pointer to the 
PIB (Program Information Block) for the last I/O started on each channel. 

Its size, or the number of bytes reserved for this information block, is always 
sufficient to allow a 24-byte field for each of the 7 channels, whether attached to 
the system or not. 

By examining the contents of this block, information relating to the last I/O started 
on any attached channel can be obtained. 

Similar information can be obtained by examining the contents of the PUB, CHANQ, 
and FOCL, but the channel bucket formats the information and, in addition, 
contains a pointer to the PIB. Information in the PIB allows more details about 
the task issuing the last START I/O instruction to be obtained. (The PIB is 
described in chapter 8 in this Section.) 



How to locate: 

Bytes X'30' - X'33' of SYSCOM contain the address of the first entry in this 
information block. Label REGSAV in the supervisor listing identifies the address 
of the first byte in this information block. 

Figure 4. 1 5 (opposite) shows the format and contents of an entry made in the 
channel bucket for a system. 
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CHNTAB 


Channel 


Channel 1 


Channel 2 


Channel 3 


Channel 4 


Channel 5 


Channel 6 






1 



\ 



\ 



\ 



/ 



\ 



\ 



\ 



/ 



\ 



\ 



/ 



/ 



\ 



\ 



/ 




\ 


Byte 0: 


X'10' = Byte Multiplexer Channel 

X"I1' = Byte Multiplexer Channel with burst mode support 

X"I3' = Byte Multiplexer Channel running in burst mode 

X'OO' = Selector Channel 

X'80' = Channel not operational or not present in the system 

X'20' = Block Multiplexer Channel 




Byte 1 : 


Always zero 





Figure 4. 14. Explanation of the contents of the Channel Control Table 



REGSAV 



i T 



J L 



\ 



\ 



| Bytes 




3 4 



7 8 



11 12 



15 16 



19 20 



I 
23 



Address of first 
PUB on Channel 


CCB Pointer 


Device Address 


PUB Pointer 


Channel Queue 
Pointer 


PIB Pointer 



Notes: 1 A channel bucket contains information related to the last I/O started on the channel. 

2 The number of channel buckets in a system equals the number of I/O channels in the system. 

Figure 4.1 5 Contents of the Channel Bucket 
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Error Recovery Block and Error Queue 

Real storage area is reserved in the supervisor for the error recovery block during 
system generation by the ERRQ parameter of the FOPT macro. 

The block is used by error queue entries that are built up by the supervisor in the 
event of an I/O device error during program operation. 

Data recorded in an error queue entry is used by both the ERP (Error Recovery 
Procedure) and RMSR (Recovery Management Support Recorder) routines. 

Each error queue entry is 44 bytes long (hex 2C), and the number of entries 
determined by the ERRQ parameter can be between 3 and 25 for a supervisor not 
supporting multiprogramming, or between 5 and 25 for a supervisor supporting 
multiprogramming. 

On the occurrence of an I/O device error that can not be corrected by hardware or 
software error recovery, a message is printed on SYSLOG. The message may require 
operator response or action, and contains data recorded in the error queue. An 
example of this type of message is: 

BG 0P47A UNX INTER V SYS003=2A1 

CCSW=02j1000B49002000000 CCB=00B440 
SNS=402Q0004024024 1 00000000000892 B 1 6 1 4020 1 0200 1 A00 1 

If no message can be printed because of the severity of the error, for example, a 
hard wait state, data recorded in the error queue should be analyzed in a dump 
output. 

By examining the contents of the error queue the following information can be 
obtained about any I/O device error recorded in the queue: 

• The status of the I/O device and the last CCW issued. 

• The active entries, if any (X'OT in byte 10). 

• The address of the associated PUB entry, from which the device address 
can be found. 

• The message code. (This code may refer to a DOS/VS message. For example, 
code 08 refers to device error recovery message 0P08A. The reason for the 
error and possible solutions are listed in DOS/VS Messages.) 

• The address of the associated CCB, from which the address of the channel 
program and I/O area used in the operation can be located. 



How to locate: 

Bytes XW - '04' of SYSCOM contain the address of the first byte in this 
information block. Label ERBLOC in the supervisor listing identifies the address 
of the first byte of this information block. 

Figure 4. 1 6 (opposite) illustrates the format and describes the contents of an error 
queue entry. 



4.60 Debugging for Programmers, part 2. 



ERBLOC 



ERRQ1 



Section 4, Chapter 3 

I/O TABLES AND 
INFORMATION BLOCKS 



o 



Name of phase 
to be fetched 
(always begins 
$$ABERR)q 



8 



Branch address 
to retry the 
the failing 
operation 



10 



11 



Branch address 
to ignore the 
error 



12 



13 



Branch address 
to cancel the 
task 



14 



15 



Return address 
for A-transient 



First error queue entry 



V. 



V 



ERROR 
QUEUE TABLE 

ERRQ1 



V 

The A-transient loads one of these address in 
register 14 before branching to the return address 
(see bytes 14-15). 



Flag byte 



PUB address 



-Message code 



10 12 



15 16 19 20 



Disk seek address 



csw 










CCB 
Address 


Sense data or 
Altern.entry name 



/ 



/ 



/ 



/ 



/ 



/ 



s 



X 



\ 



\ 



X 







\ 


Bytes 0- 7: 


CSW 


Bytes 8- 9: 


Address of PUB for device in error. 


Byte 10 


Flag byte: Bit 
1 
2 
3 
4 
5 
6 
7 


1= No record found on DASD 

1= Intervention required 

1= Passback (Set by device ERP) 

1= Allow ignore 

Not used 

1= Allow retry 

Not used 

1= Active entry. 


Byte 1 1 


Message code: may refer to a device error recovery message generated 
by physical IOCS. (See DOS/VS Messages manual.) 




This location may contain one of the following: 

X'E2' = The error is recoverable. 

X'AE' = A record is to be recorded on the system recorder file for SVC44 

or a BTAM appendage routine, and a Physical Transient is to be fetched 

(last two characters of phasename are in bytes 20-21 ). 


Bytes 12-15: 


Disk seek address 


Bytes 16-19: 


Address of CCB 


Bytes 20-43: 


Sense data: The number of sense bytes generated depends on the options 
specified; the minimum is 24 bytes. 




Alternate entry name: If byte 1 1 contains X'AE', bytes 20-21 contain the last 
two characters of the phase name of the Physical Transient to be fetched for 
SVC 44 (A3) or BTAM (A5). 

X'AF' in byte 22 indicates that the I/O area associated with an alternate entry has 
been fixed temporarily 



Figure 4.16. Explanation of the contents of the Error Block and an entry in the Error Queue 
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The data management facilities of DOS/VS are provided for by a group of routines 
collectively referred to as input/output control system (IOCS). A distinction is 
made between two types of routines: 

1. Physical IOCS (PIOCS). The physical unit I/O routines included in the 
supervisor. 

2. Logical IOCS (LIOCS). The logical unit I/O routines linked with the user's 
problem program. 



Physical IOCS 

Physical IOCS controls the actual transfer of data between the external medium 
and real storage. It performs the functions of initiating the execution of channel 
commands and handling associated I/O interrupts. Physical IOCS consists of the 
following routines: 

• Start I/O routine 

• I/O interrupt routine 

• Channel scheduler 

• Device error routines. 



Logical IOCS 

Logical IOCS performs the functions a user needs to locate and address a logical 
record for processing. A logical record is one unit of information in a file of like 
units, such as one employee's record in a master payroll file, one part number in an 
inventory file, or one customer account record in an account file. One or many 
logical records may be included within one physical record, such as a physical tape 
record (gap-to-gap). The term logical IOCS refers to the routines that perform the 
following functions: 

• Blocking and deblocking records 

• Switching between I/O areas when two areas are specified for a file 

• Handling end-of-file and end-of-volume conditions 

• Translating American National Standard Code for Information Interchange 
(ASCII) into Extended Binary Coded Decimal Interchange Code (EBCDIC) 
on input, and EBCDIC into ASCII on output 

• Checking and writing labels. 

A user's problem program normally uses LIOCS for file processing (this applies 
also to programs using POWER and VSAM files). LIOCS uses PIOCS to perform 
the data transfers. Figure 4.17 (opposite) illustrates the relationship between LIOCS 
and PIOCS using the GET macro instruction in a user program. 
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Figure 4. 1 7 Example of LIOCS and PIOCS interrelationship. 



Explanation of Figure 4.17: 

Logical IOCS makes a request to physical IOCS to start an I/O operation by means 
of the EXCP macro instruction. From information in the CCB, physical IOCS 
determines the channel for which the request was made and places the request on 
a queue for that device. If the channel(s) or device is not busy, the I/O is started 
and control returns to the problem program. If the channel is busy, control 
returns to the supervisor task selection routines, but the I/O request waits in the 
channel queue. When the request reaches the top of the channel queue, the I/O 
is started. 

Control returns to the program requesting the I/O unless there was an error 
condition detected on the START I/O (SIO) instruction. The problem program 
normally continues processing until it requires that the requested I/O operation 
be complete (either the information being read into real storage is needed, or the 
output area must be freed on an output operation). At this time, the WAIT macro 
causes the now waiting task to be removed from task selection until the proper 
interrupt is processed for this device by the supervisor. 
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Using PIOCS and LIOCS Macro Instructions. 

By use of macro instructions you can create, access and maintain files at both 
physical and logical IOCS levels. Through these macro instructions, the user can 
communicate with the pre- written routines and tailor them to his needs. 

As part of most user programs, LIOCS provides an interface between user programs, 
LIOCS provides an interface between user's file processing routines and PIOCS. 
(All COBOL, FORTRAN, RPG II, PL 1 OPT and PL/I(D) programs use LIOCS; 
most assembler programs use LIOCS.) 



Using PIOCS 

Using PIOCS requires a detailed knowledge of device control and system operation. 
A channel program using the CCW assembler instruction must be written in con- 
junction with three macro instructions provided to communicate with PIOCS. 

CCB: This macro instruction generates a command control block. (Refer to 
Chapter 5 in this Section for a description of the CCB.) 

EXCP: This macro instruction is converted to an SVCO to request execution of 
the channel program. It supplies the location of the corresponding CCB 
to the supervisor. 

WAIT: This macro instruction generates an SVC 7 which, tests CCB byte 2 bit 
(traffic bit) to determine when an I/O operation is complete. If the 
operation is not complete, the supervisor gets control until PIOCS within 
the supervisor sets the traffic bit to indicate completion of the operation. 
The WAIT macro should always be used for each I/O operation. 

The example below shows part of an assembly program listing using the EXCP 
WAIT and CCB macros. A full description of these MACRO instructions can be 
found in DOS/VS Supervisor and I/O Macros. 



























• 


003B00 


47F0 


B75C 


03F5E 


261 


^^^^^^^^^SKI^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 


















262 


•*•**••*••••*****•**•******«********••****•*••****••*••**•*•*•«•••••••* 




















263 


•BUG GENERATOR ROUTINE* 




















264 


««»♦»««**»**«»»»*»«»•»»»*»»«*»*»«*»*«»»«*»»»»»«•***••«••»»»•*»»»**«»»»» 










• 


00380* 


5010 


C61E 


04E20 


265 
266 


BUG ST I.R1SAVE SAVE CONTENTS OF RETURN REGISTER 
EXCP TCCB1 










• 










270 


WAIT TCCB1 


















276 


EXCP TCCB2 




















280 


WAIT TCCB2 










• 


003B30 


9640 


C83F 


05041 


286 


01 OPRESPl.XUO' 










003 B34 


9503 


C83F 


05041 


287 


CLI OPRESPltC't* 


(T* 


93tffcl 























^ 004E8C 
• 004E90 


40404040 
4040404040404040 


1348 


TOWN 


OC 


CLIO* • 








1349 


TCCB1 


CCB 


SYSLOGtTCCWl,X«0400« 








1360 


TCCB2 


CCB 


SYSLOGtTCCW2tX«0400« 




• 004EBA 


000000000000 












004EC0 


09004F106000001C 


1371 


TCCW1 


CCW 


09,MSSG1,X'60',28 




m 004EC8 


09004F2C60000020 


1372 




CCN 


09,MSSG2,X'60',32 




• 004 EDO 


09004F4C6000002F 


1373 




CCW 


09,MSSG3,X'60 , ,47 




004E08 


09004F7B6000001F 


1374 




CCW 


09,MSSG4,X«60',31 




. 004EE0 


09004F9A60000021 


1375 




CCW 


09,MSSG5,X'60',33 




• 004EE8 


09004FBB60000021 


1376 




ccw 


09tMSSG6 f X>60',33 




004EF0 


09004FOC60000020 


1377 




CCW 


09iMSSG7,X'60«,32 




m 004EF8 


09004FFC60000020 


1378 




CCW 


09,HSSG8,X'60',32 




• 004F00 


0900501C20000025 


1379 




CCW 


09tMSSG9,X'20',37 




004F08 


OA00504120000001 


1380 


TCCW2 


CCW 


lO.OPRESPltX^O'.l 








1381 


*********************************************************************** 


(/xyf/ft^l 






1382 


♦MESSAGE 


CONSTANTS* 
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Using LIOCS 

Logical IOCS requires a minimum knowledge of the hardware I/O devices and is 
easily implemented within the problem program by the coding of macros. This 
system is also used by most of the high-level languages to control I/O operations. 

Two types of macro instructions are available to communicate with LIOCS. 

• Imperative Macros 

These macros order an action to be performed. For example, the macro GET 
commands LIOCS to place the next record in the user's problem program area. 

• Declarative Macros 

These macros supply information about the file and about types of processing the 
I/O routine will have to perform for the user. 
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Imperative Macros 

The problem programmer issues imperative logical IOCS macro instructions to 
initiate such functions as opening a file, making records available for processing, 
writing records that have been processed, and controlling physical device operations. 
A full list can be found in DOS/ VS LIOCS Vol 1. 



Declarative macros DTF (Define the File) Macros 

For each imperative macro issued by the problem program, the assembler program 
generates an in-line expansion that links the instruction to the DTF table (and 
consequently, the logic module) for the specified file. As an operand, the imperative 
macro instruction must always contain the filename in the DTF macro describing 
the file. 

For VSAM files, the DTF macro is replaced by the ACB, EXLST and RPL macros 
to describe a file. 

Whenever logical IOCS imperative macro instructions are used in a problem program 
to control the transfer of records in a file, that file must be defined by a declarative 
DTF macro instruction. The DTF macro instruction describes (through various 
parameters specified by the problem programmer) the characteristics of the logical 
file, indicates the type of processing for the file, and specifies the virtual storage 
areas and routines, Figure 4.19 summarizes the various DTF table types supported 
by DOS/VS. Detailed descriptions of the logical IOCS file definition (DTF) macros 
and their parameters are described in Supervisor and I/O Macros. 

When one of these DTF macro instructions is encountered at assembly time, the 
assembler builds a DTF table tailored to the DTF parameters. The table contains: 

• Device CCB 

• A V-type address constant used by the Linkage Editor to resolve the linkage to the 
logic module with this DTF 

• Logic indicators; that is, one I/O area, two I/O areas, device type, etc. 

• Addresses of all of the areas (except work areas) and control functions used by 
this device. 
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Regardless of the method of assembling logic modules and DTF tables (that is, 
together with the main program or separately), a symbolic linkage results between 
the DTF table and the logic module. The Linkage Editor resolves this linkage at 
edit time. 



Byte 


Bits 


Function 


0-15 




CCB. 


(0-F) 






16 




X'08' indicates DTF 


(10) 




relocated by OPENR. 


17-19 




Address of logic module. 


(11-13) 






20 




DTF type (X'10') 


(14) 






21 





1 = No rewind. 


(15) 


1 


1 = Unload rewind. 




2 


1 = Workfile. 




3 


1 = Read backward. 




4 


1 = Write. 




5 


1 = PCINTW. 




6 


1 = Force checking of read or write. 




7 


1 = Forward space before next operation. 


22-23 




Not used. 


(16-17) 






24-25 




Record length. 


(18-19) 






26-27 




Maximum BLKSIZE. 


(1A-1B) 






28 




Read op code. 


(1C) 






29-31 




EOF address. 


(1D-1F) 






32-39 




CCW. 


(20-27) 






40-43 




Block count, initialized 


(28-2B) 




00000000 for read 
forward, 

00400000 for read 
backward. 


44 





1 = Error routine. 


(2C) 


1 


1 = Ignore. 




2 


1 = Read next record switch. 




3 


1 = Record fixed unblocked. 




4 


Not used. 




5 


Not used. 




6 


Not used. 




7 


Not used. 


45-47 




Address of error routine. 


(2D-2F) 







Note: Numbers in parentheses are displacements in hexadecimal 
notation. 

Figure 4.18. The format of the DTF table generated by a DTFMT declarative 
macro for a DTFMT workfile. 



An example of an assembly program listing is shown in Figure 4.22 that shows the 
expansion of a DTFMT macro. The macro expansion was obtained by the use of 
the assembly control statement PRINT GEN (a useful aid to use when in doubt). 
Figure 4.23 shows how this same DTFMT is printed in a system dump. The table of 
Figure 4. 1 9 (opposite) lists all the DTF codes and relates them to their specific 
files. 
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(Byte 20) 


DTF 


Description 


of DTF Table 






X'00' 




DTFCD 


Combined files 


x'or 




DTFPT 


Paper tape files 


X'02' 




DTFCD 


Reader and 3881 Optical Mark Reader files 


X'03' 




DTFCN 


Console 


X'04' 




DTFCD 


Punch files 


X'08' 




DTFPR 


Printer files 


X'09' 




DTFOR 


Optical Reader files except 3881 files 


X'OA' 




DTFOR 


Optical Reader files (HEADER=YES) 


X'OB' 




DTFMR 


Magnetic Ink Character Recognition (MICR) and Optical Reader/Sorter files 


X'OC 




DTFDR 


3886 Optical Character Reader files 


X*10' 




DTFMT 


Magnetic tape workfiles 






DTFCP 


Magnetic tape workfiles (compiler). (Note 1 ) 


x*ir 




DTFMT 


Nonstandard or unlabeled tape files 


X'12' 




DTFMT 


Standard labeled, output tape files 






DTFPH 


Standard labeled, output tape files (physical IOCS) 


X'13' 




DTFMT 


Standard labeled, input tape files (read backward) 


X'14' 




DTFMT 


Standard labeled, input tape files (read forward) 


X'1A' 




DTFDU 


Diskette I/O Unit files 


X*20' 




DTFSD 


Sequential DASD workfiles and data files 






DTFCP 


DASD workfiles (compiler) 


X'2V 




DTFPH 


Sequential DASD files, MOUNTED=SINGLE (physical IOCS) 


X'22' 




DTFDA 


Direct access files 


X'23' 




DTFPH 


Direct access files, MOUNTED=ALL (physical IOCS) 


X'24' 




DTF IS 


Indexed sequential, LOAD file 


X'25' 




DTFIS 


Indexed sequential, ADD file 


X'26' 




DTFIS 


Indexed sequential, RETRVE file 


X'27' 




DTFIS 


Indexed sequential, ADDRTR file 


X'28' 




ACB 


Access Method Control Block for VSAM files 


X'30' 




DTFCP 


Compiler file for DOS Version 1 (Note 1 ) 


X'3V 




DTFCP 


Compiler file for DOS Versions 2 and 3 


X'32' 




DTFCP 


Compiler file for DOS Versions 2 and 3 (Note 2) , 


X'33' 




DTFDI 


Device independent system unit files 


X'40' 




DTFBT 


Basic Telecommunications Access Method (BTAM) file (Notes 3 and 4) 


X'50' 




DTFQT 


Queued Telecommunications Access Method (QTAM) file (Notes 3 and 4) 


X'60' 








through 






Reserved 


X'67' 








Note 1: 


DTF type is X'30' except for tape or DASD assigned to units SYSOOO to SYSnnn. In this case, the DTFCP open 




phases change the DTF type to X'10' for tape workfiles, or X'20' for DASD work files. 


Note 2: 


DTF type is X'32' except for DASD assigned to units SYSOOO to SYSnnn. In this case, the DTFCP open phases 




change the DTF type to X'20' for DASD workfiles. 


Note 3: 


The following control unit codes are ORed into the low-order 4 bits of the DTF type code. 




Control Unit Code 




7770 1 




2848 3 




2701 4 




2702 5 




2703 6 


Note 4: 


The DTF tables for BTAM and QTAM files are not documented in this manual. They are documented in the respective 




publications DOS/VS BTAM Logic and DOS/VS QTAM Logic. 


Note 5: 


VSAM differs from other DOS/VS access methods in that it does not use a DTF. The declarative macro equivalent for 




VSAM is the ACB. (Access Control Block). 



Figure 4.19. DTF type codes. 
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MOD (Module Generation) Macros 

To speed up assembly time and save storage, LIOCS uses another type of 
declarative macro instruction. Called logic module generation macros, declaratives 
of the form xxMOD describe the type of processing that the I/O routines will 
have to do for a particular file. A module is generated that handles only what the 
user has specified. 

The module generation macros generate the data handling logic modules. These 
modules contain generalized routines needed to perform the functions of the 
logical IOCS imperative macros. The generalized routines in the logic modules are 
altered and made more specific through various parameters (specified by the 
problem programmer) included in the xxMOD macro statements. It is possible, 
therefore, to generate many variations of a particular type of logic module, each 
specifically suited to the need of the problem programmer. 

At assembly time, the assembler produces an EXTRN (External Symbol) card for 
every V-type constant (or EXTRN statement) in the user program. The assembler 
expansion of the DTF statement produces an EXTRN card with the name of the 
logic module needed to support the parameters that were specified in the DTF 
macro. The IBM-generated module names indicate the type of file and the support 
that each is capable of supplying for the DTF. Refer to Figure 4.20 for a breakdown 
of these names. Because of the descriptive nature of the IBM standard names, the 
programmer should be careful when specifying his own names for the logic modules 
to avoid overriding the IBM standard names. At the time this program is link- 
edited, the linkage editor resolves these EXTRN symbols (AUTOLINK). If the 
program is not to be executed immediately, option CATAL causes'the linkage 
editor catalogs the program into the core image library. 



1 


H 
J 
K 


xxxxxx 




L 






rlJB 


System Service and System Control 




IJC 


Card logic 




UD 


Printer logic 




IJE 


Paper tape logic 


DATA < 


IJF 


Magnetic tape logic 


MANAGEMENT 


IJG 


Sequential DASD logic 




IJH 


Indexed Sequential DASD logic 




IJI 


Direct Access DASD logic 




^ IJJ 


Device independent logic 




r IJL 


Teleprocessing routines 




IJM 


Optical Reader logic 


DATA ) 
MANAGEMENT | 


UN 
JJU 


Diskette I/O Unit logic 
Magnetic Readers logic 




IJW 


Utilities 




IJZ 


OLTEP 




IKQ 


VSAM 



Figure 4.20. A list of module names and their prefixes. 

Reentrant modules 



A re-entrant module is a logic module that can be used asynchronously, or shared 
by more than one file. The RDONLY (read only) parameter implies that the 
generated logic module is never modified in any way, regardless of the processing 
requirements of any file(s) using the module. To provide this feature, unique save 
areas external to the logic module are established, one for each task using the 
module. Each save area must be 72 bytes and doubleword aligned. Before a logic 
module is entered or an imperative macro is issued to the file, the task must provide 
the address of its unique save area in register 1 3 . 
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Interrelationships of the DTF and Module Macro Instructions 

The DTFCD, DTFDA, DTFDI, DTFDU, DTFMR, DTFMT, DTFOR, DTFPR, 
DTFPT, and DTFSD declarative macros are similar in that each of them generates 
a DTF table that references an IOCS logic module. The first 16 bytes of each table 
have the same format, that is, a command control block (CCB) and bytes 17 to 19 
contain a logic module address. The length of each table depends on the particular 
device and file type. Figure 4.19 lists the DTF device codes. To accomplish the 
linkage between the DTF table and the logic module, the assembler generates a 
V-type address constant in the DTF of a named CSECT in the logic module. To 
resolve this linkage, the linkage symbols (module names) must be identical. The 
Figure below shows the relationship of the program, the DTF, and the logic 
module. The assumed parameters have generated a request for a MTMOD named 
IJFFBCWZ. Based on this name, the linkage editor was able to locate the module. 
The GET statement generated coding to load the address of the DTF table into 
register 1 . This gives the program access to the MTMOD address, and the program 
branches to the required routine within the module. 



Section 4, Chapter 4 

I/O CONTROL 
SYSTEM 



Problem Program 



GET TAPE 




DTF Table 



TAPE DTFMT 



Module 



IJFFBCWZ MTMOD 



DC V(IJFFBCWZ) 



Figure 4.21 The relationship between imperative and declarative macros. 

See also Figure 4.24 
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PAGE 15 








LOC 


OBJECT CODE A0DR1 A0DR2 


STMT SOURCE STATEMENT 


OOS/VS ASSEMBLER REL 29.0 


20.02 73-10-05 












664 TAPEOUT DTFMT 


BLKSIZE-800. 

DEVADDR-SYS003, 

FILABL-NO, 

lOAREAl-RITETAPEi 

RECF0RM-FIX8LK, 

TVPEFLE- OUTPUT, 

WORKA«YES, 

RECSIZE-80 






C 
C 
C 
C 
C 
C 

c 

c 












665** MAGNETIC TAPE IOCS - DTFMT - 5745- 


SC-TAP - REL. 28.0 




02250028 








003FA8 




666+ OC 


0D;0; 






3-8 29400025 








k 003FA8 


000080000000 


667+TAPEOUT OC 


X;000080000003i 


CCB 




30300025 








003FAE 


01 


668* OC 


ALK1J 


LOGICAL UNIT CLASS 




30400025 








0O3FAF 


03 


669+ OC 


ALK3I 


LOGICAL UNIT 




30500025 








| 003FB0 


00003FEO 


670* OC 


AL41IJF10060) 


CCW AOORESS 




3-8 31000025 








C03FB4 


00000000 


671* OC 


4X;00; 


CCB-ST BYTE.CSW CCW ADDRESS 


3-8 31100025 








Q03FB8 


00 


672* OC 


ALKO) 






3-8 31800025 








| 003FB9 


000000 


673* OC 


VL3( IJFFZZWZ) 


AOORESS OF LOGIC MODULE 




3-8 38500025 








r 003FBC 


11 


674* OC 


X;ll; 


DTF TYPE 




39500025 








003FB0 


50 


675* OC 


ALK80) 


LOGICAL IOCS SWITCHES 




41300025 








k 003FBE 


E3C107C5D6E4E340 


676+ OC 


CL8; TAPEOUT ! 






41800025 








003FC6 


01 


677+ DC 


xsol; 






42300025 








003FC7 


60 


678+ OC 


ALK96) SWITCHES FOR OPEN 




3-8 45200025 








| C03FC8 


00 


679+ DC 


ALKO) 


SWITCH ONE FOR OPEN AND 


CLOSE 47200025 








003FC9 


000000 


680+ OC 


AL3I0I 


USER LABEL ROUTINE 




47700025 








003FCC 


00 


681+ OC 


AL1101 SWITCH 


FOR OPEN AND CLOSE 




48600025 








| 003FC0 


OO3FC0 


682+ DC 


AL3(*) 






49000025 








C03F0O 


00000000 


683+ DC 


F;o; 


BLOCKCOUNT 




49100025 






D 


003F04 


86 BC F018 00018 


684+ BXH 


11,12,24(15) 


DEBLOCKING FORWARD 




49700025 






D| 


k 0O3FD8 


41 EE 0001 00001 


685+ LA 


14,1(14) 


INCREASE BLOCKCOUNT BY ONE 


49800025 








003 FOC 


4700 0000 00000 


686+ NOP 


0(01 


LOAD USER IOREG 




50600025 








C03FEO 


010047A120000320 


687+ IJF 10060 


CCW XJ01;,RITETAPE, 


x;20;,aoo 




55600025 








| 003FE8 


000047A1 


688+ OC 


A(RITETAPE) 


ONE IOAREA 




3-10 56160026 








003FEC 


000047A1 


689+IJF20060 


OC A(RITETAPE) 


DEBLOCKER 1 




3-10 52050026 








003FF0 


00000050 


690+ OC 


F;80i 


OEBLOCKER 2 




3-10 52100026 








| 003FF4 


00004ACO 


691+ DC 


A(RITETAPE+800-1) 


DEBLOCKER 3 




3-10 52150026 








003FF8 


0320 


692+ DC 


Y(800) 


BLOCKSIZE 




52400025 








C03FFA 


03 IF 


693+ DC 


Y(800-l) 


BLOCKSIZE-1 




52600025 








> C03FFC 


004F 


694+ DC 

695 MTMOD 


YI80-1) 

WORKA=YES 


RECSIZE-1 




3-8 52900025 












696+» MAGNETIC TAPE IOCS - MTMOD - 5745 


-SC-TAP - REL. 29.0 


/DL29ZCN 00280029 








i 000000 




697+IJFFOTF DSECT 








03160025 








003000 


0000000000000000 


698+IJFFNM OC 


4F;0; 


CCB 




03200025 










00003 


699 + IJFFCB2 EQU 


1JFFNM+3 


COMMUNICATION BYTE 2 




03240025 








| 000010 


00000000 


700+ OC 


A(0) 


ADORESS OF LOGIC MODULE 




03480025 








000014 


10 


701+ DC 


x;10; 


DTF TYPE 




03520025 








000015 


00 


702+IJFFSHI DC 


xsoos 


LOGICAL IOCS SWITCHES 




03560025 








1 000016 


C605C104C 5404040 


703+ OC 


CLSiFNAME ; 










1 





















Figure 4.22. An example of an assembly listing showing the expansion of a 
DTFMT macro instruction. 

The program was assembled using the PRINT GEN assembler control statement 




10820 
"040840 
040860 
040880 
0408A0 
0408CO 
0408E0 



020CB977 
58F10010 
B960C68A 
OA020700 
001005EF 
4110CD86 



00008000 
00000000 



05EFD283 
5810CDAE 
4UOC07E 
5840C0BA 
45008792 



0C000103 
00040845 
00041019 



B983C 

B936B935 

58F10010 

4500B756 

47F0B24C 

00040878 



06640858 
00000000 
00000050 



020CB93B 
45EF000C 
00040878 
5810C0AE 
0AO2O70O 



00040860 
86BCF018 
00041338 



OOOC S810CDAE 4100000B 

CE49D203 B948C686 D206B959 CE560203 

47F0B75C 4110C0B6 4500B746 00040878 

0A0247F0 B24C5810 CDAE410Q 

4100008B 58F10010 05EE>«TO B73A0700~ 
4110CD86 450(M¥inrfM)fr¥>*Mfa ftin"'1»nf 

00041E08 U50E3C1 07C$06E4 



41EE0001 47000000 01041019 20000320 
0320031F 004F0000I 00008000 OC000103 



000408BO 000408B8 66041ED8 11D8E3C1 07C5C905 40400270 00000000 2C0407EC 

OOOOOOOF 86BCF018 41EE0001 47000000 02040CF9 00000320 00040CF9 00040E39 

00000050 00041018 0320031F 004FOOOO 47FF001C 47FF001C OOOOCOOO 00000000 

000408F8 00040900 00042230 02000202 00040960 0004021A 02040960 200000SO 



DTF 



.Q.QTA PEIN 



•-••«« fr,*f» 



Figure 4.23. An example showing how the same DTFMT is printed in a dump. 
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Problem (user) program listing. 



I/O CONTROL 
SYSTEM 




ERROPT=YES, 
| — READ=FORWARD, 
RECFORM=FIXUNB, 
TYPEFLEHNPUT 



Figure 4.24. A summary of the relationships between an imperative macro, a declarative macro, and a module 
generation macro specified in a program. 

The GET imperative macro is used in this illustration, which also shows the linkage between the generated DTF table and the 
logic module. 
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VSAM (Virtual Storage Access Method) I/O 

VSAM IOCS differs from that of other DOS/VS access methods as follows: 

• VSAM declarative macros are ACB, EXLST, and RPL instead of DTF and 
xxMOD. 

• VSAM routines are dynamically loaded into virtual storage when a VSAM 
file is opened. They are not assembled or link edited with the user's 
program. 

Declarative Macros 

The VSAM declarative macros are ACB, which creates an Access-Method Control 
Block; EXLST, which creates an Exit List; and RPL, which creates a Request 
Parameter List. The Access-Method Control Block (ACB) is like a DTF in that it 
defines the file to be processed. Opening a VSAM file involves opening the ACB 
for that file. The Request Parameter List (RPL) defines the parameters necessary 
for a particular execution of a request (imperative) macro. It contains some of the 
information, such as address of the user's work area, located in the DTF in other 
access methods. The Exit List (EXLST) contains the addresses of optional user 
exit routines. Up to four exit routines can be specified one for handling end-of- 
file, one for handling logical errors, one for handling I/O errors, and one to allow 
user processing during VSAM I/O operations. 

Codes indicating errors resulting from execution of imperative macros are set in 
registers or in the ACB or RPL as described below. 

Imperative Macros 

The user's program issues imperative macros to open or close a file and to retrieve, 
add, delete, or update records. It can also issue imperative macros to generate, 
modify, display, or test the control blocks created by the declarative macros. When 
control is returned to the user's program after execution of an imperative macro, a 
"return code" is set in the low-order byte of register 15. The return code indicates 
the results of the macro execution. If an error or certain other exceptional 
conditions occur, an "error code" will be set in the ACB, the RPL, or in register 0, 
depending on the macro. Figure xx summarizes the return codes and error codes 
issued by the imperative macros and user exit routines which can be used. More 
information on the return codes and user exits as well as a complete list of the error 
codes and their meanings is in the VSAM chapter of DOS/VS Supervisor and I/O 
Macros. 

An ACB, EXLST, or RPL can be created dynamically, during program execution, 
by using the GENCB macro. The fields in these control blocks can be modified 
during program execution by using the MODCB macro. Refer to DOS/VS 
Supervisor and I/O Macros for information on how to write the GENCB and 
MODCB macros. 

RPL Debugging Hints 

If the RPL hold byte, 35(23), is set to X'FF', the error occurred while the request 
was being executed by VSAM. Check the type of request byte, 29(1D), to 
determine what request was active. If the request was a POINT, GET, or PUT, 
check the following parameters in the RPL (of GENCB for RPL) in your program 
to ensure that they are valid: 
Macro Check these RPL Parameters 

POINT ARG and KEYLEN 

GET AREA and AREALEN 

IF OPTCD=DIR or OPTCD=SKP, also check ARG and KEYLEN 

PUT AREA and RECLEN 

If the RPL parameters are specified correctly or if the type of request is other than 
POINT, GET, or PUT, the error is probably in VSAM itself. Save the dump, console 
log, and program listing and contact your IBM programming support representative. 

Note: MODCB, SHOWCB, and TESTCB macros also set the RPL Hold byte. If this 
byte was set by one of those macros, the type of request byte will have no meaning. 
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Imperative 
Macro 


Return Code 
found in 


If Return 
Code no 0, 
Error Code 
found in 


Method of 
Inspecting 
Error Code 


Exits Taken if User Exit 
Routines are Supplied 


OPEN 

CLOSE 

TCLOSE 


Register 
15 


ACB 


Code ERROR 
parameter 
in TESTCB** 
or SHOWCB 


SYNAD EXIT FOR 
I/O errors in 
CLOSE; code 
FDBK in TESTCB** 
or SHOWCB 


GET 

PUT 

POINT 

ERASE 

ENDREQ 


Register 
15 


RPL 


Code FDBK 
parameter 
in TESTCB** 
or SHOWCB 


LERAD exit for 
logical errors* 
(Return Code 
is X'08') 
SYNAD exit for 
I/O errors 
(Return Code 
is X'OC) 


GENCB 
SHOWCB 
TESTCB 
MODCB 


Register 
15 


Register 



Inspect 

Register 




None 



* End-of-file is indicated by an error code of X'04'. The EODAD exit is taken if an EODAD routine is supplied. 
Otherwise, the LERAD exit is taken. 

** A user routine can be supplied to receive control if NSAM is unable to test for the condition specified because of 
an error occurring during execution of the TESTCB macro. The routine is pointed to by the ERET parameter 
of TESTCB. 

Figure 4.25. Summary of Error Checking for VSAM Imperative Macros 



Error Detection with VSAM Macros 

When an error occurs, the user can either attempt to correct it in his program, close 
the file, or terminate the job. These actions can be taken in the SYNAD and LERAD 
exit routines or in-line in the program. If the user wants to evaluate the error 
condition after the job has finished, he should write the error code in a field in 
his program (for locating it in a dump output) or in a message. He obtains the error 
code from the ACB or the RPL by issuing either a TESTCB or a SHOWCB macro. 

The SHOWCB macro is used to display the contents of an ACB, EXLST, or RPL 
in a work area specified by the user. The contents include the fields coded for each 
block by the user. An ACB also includes fields, such as number of levels in the 
index, read from the file's catalog entry when the file is opened. The TESTCB 
macro is used to test the value of a field or a combination of fields in the ACB, 
EXLST, or RPL. See the Supervisor and I/O Macros publication for information 
on how to write the SHOWCB and TESTCB macros. 

The SHOWCB and TESTCB macros can also be used when a task terminates 
abnormally (such as through a program check). The VSAM macro can be included 
in a routine called by the STXIT macro instruction. 
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VSAM Control Blocks 

When a VSAM file is opened, VSAM uses the information supplied by the user in 
the ACB, EXLST, and RPL along with information in the file's catalog entry to 
construct VSAM control blocks. The contents of the EXLST, RPL and ACB control 
blocks are shown in Figures 4.25 .B, C and D. Additional control blocks internal to 
VSAM are pointed to by the ACB and RPL and are described in DOS '/VS LIOCS 
Logic, Volume 4: VSAM. 



REGISTER "1 








AMBL 


ACB 




Points to 
internal 
VSAM 
control blocks 


AMBL 
EXLST 


► 




EXLST 











Figure 4.25.A. Relationship of VSAM Control Blocks 


Displacement 
dec (hex) 


Length 
in bytes 


Description and/or Contents 


0(0) 


1 


Control block identifier — X'81' 


1(1) 


1 


EXLST active byte. Set to X'FF' when file is open. 


2(2) 


2 


Length of EXLST. The length will be 10 bytes, 15 bytes, 
or 20 bytes. 


4(4) 


1 


Reserved 


5(5) 


1 


EODAD entry flags: 

X'80' — Entry present 

X'40' — Entry active 

X'20' — Entry to be dynamically loaded 


6(6) 


4 


Address of the user's EODAD exit routine. 

Set from the EODAD parameter of the EXLST macro. 


10(A) 


1 


SYNAD entry flags: 

X'80' — Entry present 

X'40' — Entry active 

X'20' — Entry to be dynamically loaded 


1KB) 


4 


Address of the user's SYNAD exit routine. Set from the 
SYNAD parameter of the EXLST macro. 


15(F) 


1 


LERAD entry flags: 

X'80' — Entry present 

X'40' — Entry active 

X'20' — Entry to be dynamically loaded 


16(10) 


4 


Address of the user's LERAD exit routine. Set from LERAD 
parameter of the EXLST macro. 


20 (14) 


1 


EXCPAD entry flags: 

X'80' — Entry present 

E'40' — Entry active 

X'20' — Entry to be dynamically loaded 


21 (15) 


4 


Address of the user's EXCPAD exit routine. 

Set from EXCPAD parameter of the EXLST macro. 



Figure 4.25.B. Explanation of the contents of the EXIT LIST (EXLST) 
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Displacement 
dec (hex) 


Length 
in bytes 


Description and/or Contents 


0(0) 


1 


Control block identifier — X'00' 


1(1) 


1 


X'OO' 


2(2) 


2 


Length of RPL 


4(4) 


4 


Relative Byte Address (RBA) of last record process or DD field indicator. 


8(8) 


4 


Address of the key or RBA which is the search argument. Set from ARG parameter or RPL or GENCB 
macro. 


12(C) 


4 


Address of user's work area which contains the logical record. Set from AREA parameter of RPL or 
GENCB macro. 


16(10) 


4 


Length of the last logical record processed. Set from the RECLEN parameter of RPL or GENCB macro 
and modified (for variable length records) by the user for a PUT macro and by VSAM for a GET macro. 


20(14) 


4 


Length of the user work area. Set from the AREALEN parameter of RPL or GENCB macro. 


24(18) 


4 


Address of the ACB 


28(1 C) 


1 


X'01' 


29(1 D) 


1 


Type of current request: 
X'00'- POINT macro 
X'04'- GET macro 
X'08'- ERASE macro 
X'OC- PUT macro (update) 
X'10'— PUT macro (insert) 
X'1 8'- Internal VSAM request 






X'lC- ENDREQ macro 

X'20' to X'24'- internal VSAM requests 


30(1 E) 


2 


Key length 


32(20) 


1 


First byte of option codes (set from OPTCD parameter of RPL of GENCB macro): 

X'80'— Keyed access 

X'40'— Addressed access 

X'20'— Sequential processing 

X'10'— Direct processing 

X'04'— Skip sequential processing 

X'02'— Control interval access 

X'01 '- Update 


33(21) 


1 


Second byte of option codes: 

X'80'— Search key greater than or equal 

X'40'— Generic key request 

X'20'— Note string position 

X'10'— No update 

X'08'— Locate mode 

X'04'— User buffer processing 


34(22) 


1 


RPL available byte. If set to X'FF" the RPL is not available for a request. If set to X'OO', the RPL is 
available for a request. 


35(23) 


1 


RPL hold byte. If set to X'FF', the RPL is active (a request has been started but has not been completed). 
If set to X'OO', the RPL is not active (no requests are in process). 


36(24) 


1 


X'FF' 


37(25) 


1 


Return code (also set in Register 15). See Supervisor and I/O Macros for a description of return codes. 


38(26) 


1 


Reserved 


39(27) 


1 


Error code (describes the type of error detected by VSAM). See Supervisor and I/O Macros for a 
description of the error codes. 


40(28) 


4 


Address of the Placeholder (PLH). This is an internal VSAM control block and is described in 
DOS/VS LIOCS Logic Volume 4: VSAM. 


44(2C) 


8 


Reserved 



Figure 4.25.C. Explanation of the contents of the REQUEST PARAMETER LIST (RPL) 
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Displacement 
dec (hex) 


Length 
in bytes 


Description and/or Contents 


0(0) 


1 


Control block identifier - X'AO' 


1(1) 


1 


ACB active byte. Set to X'FF' when ACB is open. 


2(2) 


2 


Length of ACB 


4(4) 


4 


Address of the Access Method Block List (AMBL). This is an 
internal VSAM control block and points to other internal 
VSAM control blocks. They are described in DOS/VS 
LIOCS Logic Volume 4: VSAM. 


8(8) 


4 


Address of the VSAM load module (VSAM routines). 


12(C) 


2 


Reserved 


14(E) 


2 


Number of data buffers 


16(10) 


2 


Number of index buffers 


18(12) 


1 


MACRF first byte: 
X'80' — Keyed access 
X'40' — Addressed access 
X'20' — Control interval access 
X'10' — Sequential processing 
X'08' — Direct processing 
X'04' - GET macro 
X'02' - PUT macro 
X'OT - User buffers 


19(13) 


1 


MACRF second byte: 

X'20' — Skip sequential processing 


20(14) 


1 


DOS/VS DTF identifier - X'28' 


21(15) 


1 


Open /Close flags 

X'10' - ACB is open 

X'OT — ACB will accept keyed as well as RBA requests 

Other Open/Close flags are internal to VSAM 


22(16) 


1 


x'or 


23(17) 


1 


Error code. This code describes errors that occur during Open 
Close, or TCLOSE. The codes are described in Supervisor and 
I/O Macros. 


24(18) 


4 


Size of VSAM's buffer pool 


28(1 C) 


8 


Filename of ACB. Set from label field of ACB macro or 
DDNAME parameter of ACB or GENCB macro. 


36(24) 


4 


Address of password. Set from PASSWD parameter of ACB 
or GENCB macro. 


40(28) 


4 


Reserved 


44(2C) 


4 


Address of VSAM's buffer pool 


48(30) 


4 


Address of Exit List (EXLST) 


52(34) 


4 


Reserved 



Figure 4.25. D. Explanation of the contents of the Access-Method Control 
Block (ACB) 

Note: ACB. The ACB macro produces an Access Method Control Block (ACB) 
for a VSAM file. The control block identifies the key-sequenced file and its index 
or the entry-sequenced file that is to be processed, and indicates the types of 
requests that are to be made. The ACB is similar to a DTF in that it identifies the 
file to be processed. However, most information about the file, such as key length 
and record format, is specified in the Access Method Services' (AMS) DEFINE 
command. Information supplied in this command resides in the VSAM catalog 
and is read into storage when the ACB is opened. 
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Command Control Block (CCB) CCB AND THE 

CHANNEL PROGRAM 
This information block is generated in the problem program during assembly or 
during program operation, depending on the methods of I/O control employed by 
the program. As described in Chapter 4 the CCB is generated as the first 16 bytes of 
a DTF when the program is using LIOCS. When using PIOCS, the CCB macro 
generates the CCB. 

The CCB establishes communication between the problem program and physical 
IOCS. The CCB is 16 bytes in length with eight major fields, and does not have to be 
aligned on a doubleword boundary. Eight optional bytes are generated if the user 
requests that a sense operation be performed on the occurrence of an I/O error. 
Data transferred from the device to real storage during a sense operation provides 
information concerning unusual conditions detected in the last operation and the 
status of the device. All data in the CCB is in the hexadecimal format. 

By examining the contents of the CCB in a dump, the following information can 
be obtained about the associated I/O operation: 

• Whether the operation was completed (by inspecting the traffic bit and 
device-end bit) 

Status of the channel and device to which the I/O command was issued 
The logical unit involved in the operation 
Whether the CCB is in a real or a virtual partition 
The address of the channel program (the first CCW in a CCW string) 
The address of the next CCW to be executed in the channel program 
(Subtracting eight from this address gives the address of the last CCW used.) 

• The residual count associated with the last CCW. 

This count taken from the channel status word (CSW), is stored by PIOCS when 
the pointer to this CCB is removed from the channel queue. The residual count, in 
conjunction with the original count specified in the last CCW used, indicates the 
number of bytes transferred to or from the area designated by the CCW. When an 
input operation is terminated, the difference between the original count in the 
CCW and the residual count in the CSW is equal to the number of bytes transferred 
to storage. For an output operation, the difference is equal to the number of 
bytes transferred to the I/O device. 
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CCB AND THE 
CHANNEL PROGRAM 



How to locate 

1. For programs using LIOCS, locate the address of the associated DTF in the 
program listing. Then use the linkage editor map to locate the DTF in the dump. 
The first 16 bytes of the DTF is the CCB. 



2. For programs using PIOCS, locate the address of the CCB macro in the program 
listing and use the linkage editor map to locate the CCB in the dump. 

3. If the interrupt code in the PSW stored in the partition save area is 00 or 07 
(SVC or SVC 7), the contents of general register 1 may contain the address of 
the CCB. To confirm whether the address in register 1 is that of a CCB, inspect 
the first few bytes starting from that address. (It is not difficult to recognize 

a valid CCB in a dump. See the example below.) 



FP REG 
CR O-F 



OOOOOO 
000020 



BUGPRGCK 

800*00 8C 
000420C8 
00000000 
004000FF 
0000FFFF 
BG AOOR 



00000000 
0000 E 640 
00000000 
IS 0004A0 



00000000 
47000000 



00000000 
00008SOE 
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0407E0 
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0408C0 
040AE0 
040900 
040920 
040940 
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Figure 4.26 The pointer and CCB in a dump 

Figure 4.27 parts 1, 2 and 3 illustrate the format and contents of the information 
contained in any CCB. 
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Count 



Transmis 
sion infor 
mation 



CSW 

Status 

Bits 



34 



Type 
Code 



56 



Reserved 
for 

logical 

IOCS 

8 



CCW 
Address 



11 



Reserved 
for 

physical 
IOCS 
12 



CCW 
Address 
in CSW 



13 



15 



Optional 

Sense 

CCW 



16 



23 



Section 4, Chapter 5 

CCB AND THE 
CHANNEL PROGRAM 



Byte(s) 


Description 


0-1 Used for residual Count. 






2-3 Transmitting information 
between Physical IOCS 


Byte 2 


Set on by: 








& Problem Program 


BitO: 


Traffic Bit (Wait)/(Note 5) 


PIOCS* 




Bit 1 : 


End of File(/*or /&); 3211 -UCSB Parity Check (Line 
Complete). (Note 2) 


PIOCS 




Bit 2: 


Irrecoverable I/O error 


PIOCS 




Bit 3: 


Accept Irrecoverable I/O error 


Pr. Pr.** 




Bit 4: 


5425 not ready, or return DASD Data Checks, 2671 
errors, 3540 Diskette Data Checks, or 1017/1018 errors 
to the user; indicate action-type message for Video 
Display Unit 






Bit 5: 


Post at Device End (Note 5) 


Pr. Pr. 




Bit 6: 


Return Tape Read Data Check; 1018 or 2560 Data 
Check 2520, 2540, 2560, 3881 or 5425 Equipment 
Check Accept 3504, 3505 or 3525 Perm. Error, DA 
SD-Data Checks on Read or Verify Command on 321 1 
or 2245 Passback Requested. 
(Notes 3, 6 and 8) 






Bit 7: 


User Error Routine 


Pr. Pr. 


Byte 3 


Set on by: 


BitO: 


DASD-Data Check in Count Area; Permanent Error for 


PIOCS 






3330, 3340; MICR-SCU Not Operational; 1287/1288- 








Data Check; 3211 -Print Check/Equipment Check; 








3540 Special Record Transferred. 






Bit 1: 


DASD-Track Overrun; MICR-lntervention required; 

1 287-Keyboard Correction in Journal Tape Mode; 1017- 

Broken Tape; 3211 -Print Quality/Equipment Check. 


PIOCS 




Bit 2: 


DASD-End of Cylinder; MICR-(Note 4); 1287/1288- 
Hopper Empty in Document Mode. 3211/2245-Line 
Position Error. (Note 7) 






Bit 3: 


2520, 3881 -Equipment Check; 2560, 3203, 5203, 
5425 Data Check/Equipment Check; Tape-Read 
Data Check; DASD-Any Data Check. 1287-Equipment 
Check; 1017/1018-Data Check; 3211 -Print Check/Data 
Check; 3504, 3505, 3525 Perm. Error, (Note 8); 
3540 Diskette Data Check. 


PIOCS 




Bit 4: 


Non-Recovery Questionable Condition: Card-Unusual 
Command Sequence; DASD- No Record Found; 1287/ 
1288- Document Jam or Torn Tape; 321 1 -UCSB Parity 
Check (Command retry); 5425 not ready 


PIOCS 




Bit 5: 


No Record Found Condition (Retry on 2311, 2314, 
2319, 3330 or 3340) 


Pr. Pr. 




Bit 6: 


Carriage Channel 9 Overflow or Verify Error for DASD; 
1287-Document Mode-Late Stacker Select; 1288-End of 
Page. 


PIOCS 




Bit 7: 


Command Chaining, Retry from the next CCW to be 
executed 


Pr. Pr 



•Physical IOCS **Problem Program 

Figure 4.27 Explanation of the contents of the CCB, part 1 of 3 
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Reserved 




Reserved 








Transmis- 


csw 










CCW 


Optional 


Count 


sion infor- 
mation 


Status 
Bits 


Type 
Code 


for 

logical 

IOCS 


CCW 
Address 


for 

physical 

IOCS 


Address 
in CSW 


Sense 
CCW 


1 


2 3 


4 5 


6 7 


8 


9 11 


12 


13 15 


16 23 



Byte(s) 



4-5 CSW Status Bits 



6-7 Type Code 



Description 



Byte 4 (Note 1) 



Bit 0(32) Attention 

1 (33) Status Modifier 
2(34) Control Unit End 
3(35) Busy 
4(36) Channel End 
5(37) Device End 
6(38) Unit Check 
7(39) Unit Exception 



Byte 5 



Bit 0(40) Program Controlled 
Interruption 
1 (41 ) Incorrect Length 
2(42) Program Check 
3(43) Protection Check 
4(44) Channel Data Check 
5(45) Channel Control Check 
6(46) Interf. Control Check 
7(47) Chaining Check 



Byte 6 



X'Ou' Original CCB (Bytes 9-11 and 13-15 contain virtual addresses 
X'2u' Translated CCB (Byte 9-1 1 contain real address, bytes 1 3-1 1 

virtual address) 
X'4u' BTAM request original CCB (Bytes 9-11 and 13-15 contain 

virtual addresses) 
X'6u' BTAM request translated CCB (Bytes 9-1 1 contain real address, 

bytes 1 3-1 5 virtual address) 
X'8u' User-translated CCB in virtual partition (Bytes 9-11 and 13-15 

contain real addresses) 

Note: Any one of the above incremented by X'10' (bit 3 on) indicates 
automatic switching to the beginning of the next cylinder at 
End of Cylinder condition, 
u: 0= The address in byte 7 refers to a System Logical Unit. 

1= The address in byte 7 refers to a Programmer Logical Unit. 



Byte 7 



Hexadecimal representation of SYSnnn: 



SYSRDR 


= 00 


SYSIPT 


= 01 


SYSPCH 


= 02 


SYSLST 


= 03 


SYSLOG 


= 04 


SYSLNK 


= 05 


SYSRES 


= 06 


SYSSLB 


= 07 


SYSRLB 


= 08 


SYSUSE 


= 09 



SYSREC 


= 0A 


SYSCLB 


= 0B 


SYSVIS 


= OC 


SYSCAT 


= 0D 


SYS000 


= 00 


SYS001 


= 01 


SYS002 


= 02 


SYSnnn 




(Note 9) 





Figure 4.27. Explanation of the contents of the CCB, part 2 of 3 
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Section 4, Chapter 5 

CCB AND THE 
CHANNEL PROGRAM 



— 

Count 


Transmis- 
sion infor- 
mation 


csw 

Status 
Bits 




Type 
Code 




Reserved 
for 

logical 
IOCS 


CCW 
Address 


Reserved 
for 

physical 
IOCS 


CCW 
Address 
in CSW 


Optional 

Sense 

CCW 


1 


2 3 


4 


56 


7 


8 


9 11 


12 


13 15 


16 23 



Byte(s) 


Description 


8 Reserved for 
Logical IOCS 


Buffer Offset 

ASCII Input Tapes X'00'-X'63' 

ASCII Output Tapes Fixed X'OO' 
Variable X'OO' or X'04' 
Undefined X'OO' 


9-1 1 CCW Address 


Virtual or real address of CCW associated with this CCB depending 
on byte 6: 

Real address if byte 6= X'2u\ X'6u', or X'8u'; 
Virtual address if byte 6= X'Ou', or X'4u'. 


1 2 Reserved for 
Physical IOCS 


X'80' CCB being used by ERP 

X'40' Channel Appendage Routine present for TP device, VSAM 

or POWER 
X'20' Sense Information desired 
X'10' Message writer 
X'08' EU Tape Error 
X'04' OLTEP Appendage available 
X'02' Tape ERP Read Opposite Recovery 
X'OV Seek Separation 


13-15 CCW Address 
- in CSW 


Virtual Address of CCW pointed to by CSW at Channel End 
(if byte 6= X'8u', it is the real address) or address of the 
Channel End Appendage Routine for TP devices, 
VSAM or POWER. 


16-23 Optional 
Sense CCW 


8 bytes appended to the CCB when Sense Information is 
desired. 



Note 1 : Bytes 4 and 5 contain the status bytes of the Channel Status Word (Bits 32-47). 
If byte 2, bit 5 is on and device end results as a separate interrupt, device end 
will be OR-ed into CCB byte 4. 

Note 2: Indicates /* or/& statement on SYSRDR or SYSIPT. 
Byte 4, bit 7 (unit exception) is also on. 

Note 3: DASD data checks on count not returned. 

Note 4: For 1255/1259/1270/1275/1419, disengage. For 1275/1419D, I/O Error is 
external interrupt routine (Channel data check or bus-out check). 

Note 5: The traffic bit (Byte 2, bit 0) is normally set on at channel end to signify that the 
I/O was completed. If byte 2, bit 5 has been set on, the traffic bit and bits 2 and 6 
in byte 3 will be set on at device end. Also see Note 1 . 

Note 6: 1018 ERP does not support the Error Correction Function. 

Note 7: This error occurs as an equipment check, data check or FCB parity check. 
For 2245, this error occurs as a data check or FCB parity check. 

Note 8: For 3504, 3505, 3525 input or output files using ERROPT, byte 3-bit 3 is set on if a 
permanent error occurs. Byte 2-bit 6 is set on to allow you to accept permanent errors. 

Note 9: SYSnnn= 255-(Number of partitions x 14). 

Figure 4.27. Explanation of the contents of the CCB, part 3 of 3. 
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CCB AND THE The channel program 

CHANNEL PROGRAM 

A channel program consists of one or more CCWs (channel command words). The 
channel program is generated during assembly or during program operation, 
depending on the method of I/O control employed by the program. A CCW specifies 
the command, the storage area to be used for the I/O operation, and the action to 
be followed when the operation is completed. When a program is running in a 
virtual partition, the CCWs are copied into the real address area. 

Translation from the virtual I/O area addresses in the CCW to real addresses is 
accomplished either by the supervisor channel program translation routines. 

The contents of CCWs should be inspected when the cause of a system malfunction 
leads you to suspect I/O operation errors. For example, parts of a program being 
overwritten and causing invalid instructions, or unexpected information in your 
program I/O data area will probably cause a program check and generate incorrect 
output from your program. 

By examining the contents of the channel program the following information can 
be obtained: 

• Validity of the operation code and of the sequence of CCWs used. If either of 
these is invalid, an informatory message is normally printed on SYSLOG to 
help you to determine the cause of the error. 

(Consult the component manual for the I/O device for the valid codes and 
sequence of use.) 

• Data address in the last CCW used. Translated channel programs are 
destroyed in a system dump by the channel programs required for the DUMP 
and by channel programs started for other partitions. However, they can be 
located in a stand-alone dump, an example of which is shown in Appendix G. 
(Refer to chapter 12 in this section for methods of translating real addresses 
to virtual and vice-versa.) 

• Count in the CCW. This must be a byte count of one or more for any I/O 
operation not involving magnetic tape units. (For a transfer in channel (TIC) 
command, the count may be zero.) 

• When working with wrong length records or variable length records, the 
suppress length indicator should be set to 1 to prevent an error condition. 
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How to locate: 



Bits 8-31 of the CSW (Channel Status Word) stored in location X'40' of low 

address storage contain the address of the next CCW to be executed. Subtract 

eight from this address to obtain the address of the last CCW used. (Refer to 

Section 2-E-2 for details of low address storage.) 

Caution: The data stored in low address storage may be overwritten by the 

dump program. If this is thought to be the case, use the method described 

below. 

Bytes 9-11 of the CCB associated with the channel program contain the 

addresses of the first CCW in the channel program. Bytes 13-15 of the same 

CCB contain the address of the next CCW. Subtract eight from this address 

to obtain the address of the last CCW used. 

The figure below shows the format and contents of any CCW. 



Section 4, Chapter 5 

CCB ANDTHE 
CHANNEL PROGRAM 



CC Va3 



Command 


Data Address 


Flags 


00 


TP code 


Count 



32 



38 



40 



48 



63 



FIELD 


DESCRIPTION 


Command 
Code 


Bits 0-7: 

Specify the operation to be performed. / 
Consult device component manual 


Data Address 


Bits 8-31 : 

Specify the location Of a byte in main storage. It is the first location 
referred to in the area designated by the CCW. 


Flags 


Bits 32-36: 

Specify the flag bits used in conjunction with the CCW. 

Bit 32- 

Chain-Data (CD) causes the address portion of the next CCW to be 
used with the current CCW. 

Bit 33- 

Chain-Command (CC) causes the command code and data address 
of the next CCW to be used. The chain data flag (bit 32) takes 
precedence over this flag. 

Bit 34- 

Suppress Length Indication (SLI) causes a possible incorrect length 
indication to be suppressed. The chain data flag (bit 32) takes 
precedence over this flag. 

Bit 35- 

Skip (SKIP) suppresses the transfer of information to real storage. 

Bit 36- 

Program Control Interruption (PCI) causes the channel to generate 

an interrupt when the CCW is fetched. 
Bit 37- 

IDAL bit. Set to 1 if I/O area crosses page boundary, that is, if the 

I/O area is not confined to one page frame in real storage. 


Reserved 


Bits 38-39: 

(Must contain zeros)* 


TP 


Bits 40-47: 


Count 


Bits 48-63: 

Specify the number of bytes in the operation 



*The transfer in channel command (TIC) is the one exception to this statement. 
Figure 4.28. Explanation of contents of the CCW 
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SUPERVISOR GALLS A problem program running in any partition fields control to the supervisor by 

issuing a supervisor call instruction. The SVC instruction contains a code that 
indicates its purpose. For example, SVC requests the supervisor to execute the 
channel program. Some SVCs are optional and cause program cancellation if the 
supervisor does not support the option requested. 

A complete list of DOS/VS SVC codes with the associated macro instructions that 
generate the SVC is shown in Figure 4.29 parts 1, 2 and 3. 

A detailed description of the SVCs can be found in DOS/VS Supervisor Logic. 



4.84 Debugging for Programmers, part 2. 



SVC 










Macro supported 


Function 


Dec 


Hex 












EXCP 


Execute Channel Program 


1 


1 


FETCH 


Fetch any phase 


2 


2 




Fetch a logical transient (B-transient) 


3 


3 




Force dequeue 


4 


4 


LOAD 


Load any phase 


5 


5 


MVCOM 


Modify supervisor communication region (if issued by 
MVCOM macro) Fetch anyother physical transient (if 
issued by a physical transient) 


6 


6 


CANCEL 


Cancel a problem program or task 


7 


7 


WAIT 


Wait for a CCB or TECB 


8 


8 




Transfer control to the problem program from a logical 
transient (B-transient) 


9 


9 


LBRET 


Return to a logical transient (B-transient) from the 
problem program after an SVC 8 


10* 


A 


SETIME 


Set timer interval 


11 


B 




Return from a logical transient (B-transient) 


12 


C 




Reset switches in partition communication region. 


13 


D 




Set switches in partition communication region. 


14 


E 


EOJ 


Cancel job and go to job control for end of job step 


15 


F 


SYSIO 


Headqueue and execute channel program 


16* 


10 


STXIT(PC) 


Provide supervisor with linkage to user's PC routine 
for program check interrupts 


17* 


11 


EXIT(PC) 


Return from user's PC routine 


18* 


12 


STXIT(IT) 


Provide supervisor with linkage to user's IT routine 
for interval timer interrupts 


19* 


13 


EXIT(IT) 


Return from user's IT routine 


20* 


14 


STXIT(OC) 


Provide supervisor with linkage to user's OC routine for 
external or attention interrupts (operator comm.) 


21* 


15 


EXIT(OC) 


Return from user's OC routine 


22 


16 


SEIZE 


Seize/release system; enable/disable for external and 
I/O interrupts; set key in users PSW 


23* 


17 




Load phase header. Phase load address is stored at 
user's address 


24* 


18 


SETIME 


Set timer interval and provide supervisor with linkage 
to user's TECB, if any 



Section 4, Chapter 6 

SUPERVISOR CALLS 



optional 



Figure 4.29 Supervisor Calls (Part 1 of 3) 
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SUPERVISOR CALLS 



SVC 
Dec 


Hex 


Macro Supported 


Function 


25* 


19 




Issue HALT I/O on a teleprocessing device, or HALT I/O 
on any device if issued by OLTEP. With multiprogramming 
dequeue an unstarted OLTEP I/O request to a shared 
device 


26* 


1A 




Validate address limits 


27* 


1B 




Special HIO on teleprocessing devices 


28* 


1C 


EXIT(MR) 


Return from user's stacker select routine (MICR type 
devices only) 


29* 


1D 


WAITM 


Provide support for multiple wait macro WAITM 


30* 


1E 


QWAIT 


Wait for a QTAM element 


31* 


1F 


QPOST 


Post a QTAM element 


32 


20 




Reserved 


33 


21 




Reserved for COM RG macro 


34 


22 


GETIME 


Provides Time-of-Day and updates the DATE field 


35* 


23 


HOLD 


Hold a track for use by the requesting task only 


36* 


24 


FREE 


Free a track held by the task issuing the FREE 


37* 


25 


STXIT(AB) 


Provide supervisor with linkage to user's AB routine for 
abnormal termination of a task 


38* 


26 


ATTACH 


Initialize a subtask and establish its priority 


39* 


27 


DETACH 


Perform normal termination of a subtask. It includes 
calling the FREE routine to free any tracks held by the 
subtask 


40* 


28 


POST 


Inform the system of the termination of an event and 
ready any waiting tasks 


41* 


29 


DEQ 


Inform the system that a previously enqueued resource is 
now available 


42 


2A 


ENQ 


Prevent tasks from simultaneous manipulation of a shared 
data area (resource) 


43 


2B 




SDR SVC 


44* 


2C 




Provide supervisor support for external creation of unit 
check records by specific request 


45* 


2D 




Provide emulator interface 


46* 


2E 




Provide OLTEP with the facility to operate in supervisory 
state 


47* 


2F 


WAITF 


Provide support for multiple wait macro for MICR type 
devices 


48* 


30 




Fetch a CRT transient 


49 


31 




Reserved 



optional 



Figure 4.29 Supervisor Calls (Part 2 of 3) 
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SUPERVISOR CALLS 



SVC 
Dec Hex 


Macro supported 


Function 


50 


32 




Reserved for LIOCS error recovery 


51 


33 




Return phase header 


52* 


34 


TTIMER 


Return the remaining time interval, or cancel a time 
interval 


53 


35 




Reserved 


54 


36 


FREEREAL 




55 


37 


GETREAL 


Provide interf. between SDAID and PDAID initialization 
routine and page management routine, to create the 
PDAID alternate area or the SD area 


56* 


38 


GETPUB- 








FREEPUB 


Occupy or free PUB of the device used by POWER 


57* 


39 




Make POWER-supported partition dispatchable 


58 


3A 




Provide interface between job control and the supervisor. 
Get real storage for real jobs 


59 


3B 




Provide interface between EOJ and the supervisor. Reset 
the storage key for virtual jobs 


60 


3C 


GETADR 


Provide virtual address of location within I/O areas for 
ERP and CRT routines 


61* 


3D 


GETVIS 


Get storage in virtual partition 


62* 


3E 


FREEVIS 


Free storage in virtual partition 


63 


3F 


USE 


Use a resource 


64 


40 


RELEASE 


Release a resource 


65* 


41 


CD LOAD 


Load VSAM or core image phase 


66. 


42 


RUNMODE 


Return mode in which program is running 


67* 


43 


PFIX 


Fix page(s) in real storage 


68* 


44 


PFREE 


Free page(s) in real storage 


69* 


45 


REALAD 


Return real address corresponding to a given virtual 
address 


70* 


46 


VIRTAD 


Return virtual address corresponding to a given real 
address 


71* 


47 


SETPFA 


Establish or terminate the linkage between the supervisor 
and a user page-fault appendage routine 


72* 


48 


GETCBUF- 








FREECBUF 


Get or free copy buffer for I DAL or tape ERP 


73* 


49 


SETAPP 


Allow linkage to channel and appendage routines 


74* 


4A 




Fix page(s) in real storage for restart 


75 


4B 




Reserved 


76 


4C 




Initiate recording of a RMS I/O error 


77 


4D 


TRAWSCSW 


Returns the virtual address of a copied CCW 


78 thru 84 




Reserved 


85 


55 


RELPAG 


Release contents of one or more pages 


86 


56 


FCEPGOUT 


Force a page-out for one or more pages 


87 


57 


PAGEIN 


Page in one or more pages 



* optional 
Figure 4.29 



Supervisor Calls (Part 3 of 3) 
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PIB ANDPIB2 



The PIB (program Information Block) 

Real storage area is reserved in the supervisor for this information block by the 
MPS multiprogramming and/ or NPARTS and AP (Asynchronous Processing) 
parameters of the SUPVR supervisor generation macro/Each entry in this block is 
16 bytes and contains status information about the program and, if AP is supported 
about the subtasks running in each partition supported by the supervisor. 

The first entry is reserved for the attention routine, this entry is called the 
Attention PIB (AR PIB). 

Other entries in the PIB belong to the problem programs and subtasks. The sum of 
all subtasks and problem program entries may not exceed 15. The maximum number 
of entries, including the attention PIB and AP (subtask) PIBs, is 16. 

For a supervisor that is not generated to support more than one partition there is 
only one 1 6-byte entry, which is shared by the attention routine and the 
problem program. 

By examining the data recorded in the appropriate PIB entry, the status and 
location of programs running in any partition can be established. Some of the 
more important data to be looked at in the PIB during the first analysis of a dump 
output are: 

• Byte 0, from which you can determine whether the program is waiting for 

• The LTA (Logical Transient Area), X'81' 

• The PTA (Physical Transient Area), X'85' 

• An I/O interrupt, X'82' 

• A page to be paged in, X'87' 

• A page to be paged in with QTAM active, X'8F' 

• Byte 4, X'80', which indicates that the job or task is running in virtual mode 

• The address of the program save area 

• The address of the system save area. 

Figure 4.30 (opposite) shows the format and describes the contents of an entry 
in the PIB. 



How to locate: 

Bytes X'5A' — X'5B' of the partition comregs contain the address of the first entry 
in this information block. Label PIBTAB in the supervisor listing identifies the 
address of the first byte of this information block. 

Appendix G shows an example of locating the PIB in a dump output. 
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PIBTAB 



:■■■ : 

Attention 


pte 


Backgroun 


d PIB 


FG4 


PIB 


FG3 


PIB 


FG2 


PIB 


FG1 


PIB 


Subtask 


PIB 






Subtask 


PIB 




Format of 
Attention PIB 
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PIB AND PIB2 






1 


2 3 


4 


5 6 7 


8 


9 10 11 


12 


13 


14 


15 




Flag 
Byte 


Cancel 


SYSLOG 


always 


Inactive = zero 


Switch 


Address of save 


X'07' 


BG 


Number 


Not 




Code 


ID 


zero 


Active = Address 


Byte 


area of zero 


PIB 


user 


of BG 


used 








(AR) 




of LTA save area 




(Note 1) 


assign 
flag 


LUB 
index 


pro- 
gram 






(See A) 








(Note 2) 


(See F ) 


(Note 2) 


(See D) 




LUB's 







Note 1: a) When L TA is inactive= L TA save area address. 

b) When L TA is active for Problem Programs, this address is exchanged with that in the Problem Program PIB. 



Note: 



When L TA is active for Logical Attention, bytes 9-11 are zero and bytes 5- 7 contain the L TA save area address. 




Format of any 
Probl. Program 
or Subtask PIB 



Legend: A, B, C, D, E, F refer to next 
part of this figure, which 
describes the meaning of each 
bit in a PIB entry 






1 


2 3 


4 


5 6 7 


8 


9 10 11 


12 


13 


14 


15 




Flag 


Cancel 


SYSLOG 


DAT 


Address of Problem 


Gate 


Address of sys- 


PIB 


User 


Number 


Flag 




Byte 


Code 


ID 


flag 


Program save area or 
LTA save area 


ID 


tem save area 


assign 
flag 


LUB 
index 


of 
Pro- 
gram 


Byte 




(See A ) 






(See B ) 


(Note 3) 


(See C ) 




(See D) 




LUB's 


(See E ) 





Note 3: When the Logical Transient Area is active the save area address in the Problem Program PIB is exchanged with that in the 
Attention PIB. 

The number of Problem Program PIBs generated depends on the number of partitions specified during system generation. 
Subtask PIBs are generated only if AP= YES has been specified during system generation. 
The number of subtask PIBs generated depends on the number of partitions, that is: 



Figure 4.30 Explanation of the contents of an entry" in the PIB, 
part 1 of 3. 



No. of partitions No. of subtasks 



13 
12 
11 
10 
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Flag Byte (First byte in PIB) 

The following flags are always used: 

X'71 ' = Program is waiting for SVC58 

X'73' = Program is waiting because system is seized 

X'75' = Program is waiting for copy block 

X'77' = Program is waiting for TFREE 

X'79' = Program is waiting for channel queue entry 

X'7B' = Program is waiting for CCW translation 

X'7D'= Program is waiting for a free Console Buffer 

X'80' = Program is not active 

X'81' = Program is SVC2-bound (waiting for the LTA to be released) 

X'82' = Program is SVC7-bound (waiting for an I/O interruption) 

X'83' = Program is ready to run 

X'85' = Program is SVC5-bound (waiting for the PTA to be released) 

X'86' = Initial selection of RAS (used only for RAS PIB flag) 

X'87' = Program is set to common bound condition 

The following flags are used only if NPARTS = 1 . X'61' through X'69' are used 
by the load leveller to deactivate a partition. The partition to which a flag 
refers depends on NPARTS as follows: 









NPARTS - 








2 


3 


4 


5 


X'61' 


refers to 


BG 


BG 


BG 


BG 


X'63' 


refers to 


F1 


F2 


F3 


F4 


X'65' 


refers to 


- 


F1 


F2 


F3 


X'67' 


refers to 


- 


- 


F1 


F2 


X'69' 


refers to 


— 


— 


— 


F1 



X'6B' = Program is SVC35-bound 

X'6D' = Program is waiting for next freed page frame 

X'6F' = Program is IDRA-bound 

The following flags are only used if AP= YES: 

X'51' = Program is SVC38-bound 
X'53' = Program is SVC41/42-bound 

The following codes are only used if AP= YES and PFIX= YES. 

The codes are used by the PFIX routines to set a partition PFIX bound. 

The partition to which a flag refers depends on NPARTS as follows: 









NPARTS = 








2 


3 


4 


5 


X'47' 


refers to 


BG 


BG 


BG 


BG 


X'49' 


refers to 


F1 


F2 


F3 


F4 


X'4B' 


refers to 


- 


F1 


F2 


F3 


X'4D' 


refers to 


— 


- 


F1 


F2 


X'4F' 


refers to 


— 


— 


— 


F1 



The following codes are used only if AP= YES and VSAM= YES. 

The codes are used by the VSAM routines to set a partition PFIX bound. 

The partition to which a flag refers depends on NPARTS as follows: 









NPARTS = 








2 


3 


4 


5 


X'3D' 


refers to 


BG 


BG 


BG 


BG 


X'3F' 


refers to 


F1 


F2 


F3 


F4 


X'41' 


refers to 


- 


F1 


F2 


F3 


X'43' 


refers to 


— 


— 


F1 


F2 


X'45' 


refers to 


— 


— 


— 


F1 



Figure 4.30 Explanation of the contents of an entry in the PIB, part 2 of 3. 
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B PIB DAT Flag 

X'01' = Return to re-entrant supervisor routine 

X'02' = Return to gated supervisor routine 

X'04' = Move CCB at dispatching time 

X'08' = Service delayed external interrupt 

X'10' = Task is temporarily deactivated 

X'20' = Reserved 

X'40' = Task has seized the system 

X'80' = Program is running in virtual mode 

C Gate Identifier 



X'71 ' = Gating of SVC58 required 
X'53' = Gating of SVC41/42 required 

The flags are only used if the PIB DAT Flag is X'03\ that is, the first two 
flags are on (See B ). 

D PIB Assign Flag 

X'80' = SYSRES DASD file protect inhibited (allow write operation on SYSRES) 

X'40' = Channel appendage exit allowed (BTAM) 

X'20' = Cancel in progress (used in terminator function) 

X'10' = Cancel control (set on a foreground cancel) 

X'08' = Hold foreground assignments 

X'07' = Attention PIB 

E Problem Program PIB Flag (Last byte in PIB) 



BitO 
Bit 1 
Bit 2 
Bit 3 
Bit 4 
Bit 5 
Bit 6 
Bit 7 



1= Batched job in foreground (always on when tested) 
1 = Cancel in LTA and device not assigned 
1=/&onSYSIN if DASD 
1= Partition in stopped state 
1= Fetch EOJ monitor 
1= Task is canceled 
1= Subtask(s) attached 
1= in AB routine 



Attention PIB Switch Byte 



BitO 
Bit 1 
Bit 2 
Bit 3 
Bit 4 
Bit 5 
Bit 6 
Bit 7 



Reserved 

Reserved 

1= Delay cancelation 

1= Emergency cancel request 

1= Detach Logical Attention Routine (SSBATTNA) 

Reserved 

1 = Fetch Logical Attention Routine (SSBATTNA) 

1 = External Interrupt request 
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Figure 4.30. Explanation of the contents of an entry in the PIB, part 3 of 3 
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PIB AND PIB2 PIB2 (Program Information Block Extension) 



As the name of this block implies, it is an extension of the PIB and is of identical 
size, being generated with the PIB during system generation. Data recorded in each 
16-bytes entry supplements the data recorded in the PIB. 

By examining the contents of bytes and 1 of the appropriate problem program 
PIB2 entry, the address of the associated partition communication region can be 
established. 



How to locate: 

Bytes X'7C - X'7D' of the partition comregs contain the address of the first entry 
in this information block. Label PIB2TAB in the supervisor listing identifies the 
address of the first byte of this information block. 

Appendix G shows an example of locating the PIB2 in a dump. 
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PIB AND PIB2 



PIB2TAB 



Attention 


PIB 


Background PIB 


FG4 


PIB 


FG3 


PIB 


FG2 


PIB 


FG1 


PIB 


Subtask 


PIB 




Subtask 


PIB 



Format of any 
PIB extension 
entry 
1 2 



3 4 



7 8 



10 



11 12 



13 14 



15 



16-bit 
















Address of com- 


System 


Interrupt 




Address of termination ECB 


Program 


un- 


Flag 


munication 


LUB index 


Information 




if any, otherwise zeros 


Interrupt 


used 


Byte 


region of 










Key (PIK) 




(See 


partition 














B 


(Note 1 ) 




(See table A 


below) 








below) 



Note 1: Always BG communication region in Attention— and Background PIB extension. Appropriate communication region in other 

PIB extensions when a multiprogram system has been generated. To place this address in a register, the instruction I CM should 

be used. 

For each PIB Table entry, an entry exists in the PIB Table Extension. 



Type of interruption 


Contents of PIB Extension Bytes 


4 


5 


6 | 7 


SVC 
PC 

I/O 


00 
00 
00 


ILC* 
ILC* 
00 


Interruption Code 
Interruption Code 
I/O Address 



ILC (Instruction Length Code) is in bits 5 and 6; other bits are zeros. 



Byte 14 


Byte 1 5 




Bit 0: 1= POWER runs in this partition 




Bit 1:1= This partition is supported by 


Not used 


POWER, if POWER is active 




2: 1= Task owns CRT 




3-7: Not used 



Figure 4.31. Explanation of the contents of an entry in the PIB2 
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CANCEL CODES 



Byte 1 of the PIB contains a cancel code that is stored by the supervisor in the 
event of program cancellation. Normally a message is printed on SYSLOG and/or 
SYSLST that informs the operator about the reason for the cancellation, for 
example: 



BG 0S04I ILLEGAL SVC 



HEX LOCATION 007884 



SVC CODE 14 



The cancel code (stored in byte 1 of the associated partition PIB) should be 
examined also in the event of a system malfunction such as a LOOP or WAIT STATE 
that prevents the system from issuing an error message. 

Figure 4.32 (below) shows a list of all the cancel codes and their message prefixes. 

All these cancel codes cancel the program, task, or subtask when they occur. If 
multitasking is being used and a main task is canceled, all of the subtasks attached 
are detached and canceled as a result of the main task being canceled. If a dump 
option was specified at system generation time or by job control, the contents of 
the supervisor and the partition in which the cancel condition occurred is printed 
on SYSLST. 



Cancel 


Message 


Descriptive part of Message 


Code (hex) 


Code 


or Condition 


10 




Normal EOJ 


11 


0V07I 


No channel program translation for unsupported device 


12 


0V06I 


Insufficient buffer space for channel program translation 


13 


0V05I 


CCW with count greater than 32 K 


14 


0V04I 


Page pool too small 


15 


0V02I 


Page fault in disabled program 


16 


0V01I 


Page fault in MICR stacker select or PHO routine 


17 


0S02I 


Program request (Same as 23 but causes dump because subtasks 




were attached when maintask issued CANCEL macro) 


18 




Eliminates cancel message when maintask issues DUMP macro 
with subtasks attached 


19 


0P74I 


I/O operator option 


1A 


0P73I 


I/O error 


1B 


0P82I 


Channel failure 


1C 


0S14I 


CANCEL ALL macro 


1D 


0S12I 


Main task termination 


1E 


0S13I 


Unknown ENQ requestor 



Figure 4.32. DOS/VS Cancel Codes and Messages, part 1 of 2. 
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Cancel 


Message 


Descriptive part of Message 




Code (hex) 


Code 


or Condition 




1F 


0P81I 


CPU failure 




20 


0S03I or 
0S11I 


Program check 




21 


0S04I or 
0S09I 


Illegal SVC 




22 


0S05I or 
0S06I 


Phase not found 




23 


0S02I 


Program request 




24 


0S01I 


Operator intervention 




25 


0P77I 


Invalid address 




26* 


0P71I 


SYSxxx not assigned (unassigned LUB code) 




27 


0P70I 


Undefined logical unit 




28 




QTAM cancel in progress 




29 


0S15I 


No relocating loader support (Fetch or load request for 








relocatable phase while supervisor does not support relocat 


ng 






load) 




2A 


0P84I 


I/O error during fetch (irrecoverable I/O error during fetch 




2B 


0V10I 


I/O error on page data set 




2C 


0V09I 


Illegal parameter passed by PHO routine 




2D 


0P88I 


Program cannot be executed/restarted due to failing storage block 


2E 


0S16I 


Invalid resource request (possible deadlock) 




2F 


0V03I 


More than 255 PFIX requests for 1 page 




30 


0P721 


Reading past /& statement (on SYSRDR or SYSIPT) 




31 


0P75I 


I/O error queue overflow (error queue over-flow) 




32 


0P76I 


Invalid DASD address 




33 


0P79I 


No long seek (disk) 




34 




Reserved 




35 


0P85I 


Job control open failure 




36 


0V08I 


Page fault in I/O appendage routine 




37 




Reserved 




38 


0V11I 


Wrong privately translated CCW 




39 




Reserved 




FF 


0P78I 


Unrecognized cancel code 






0P83A** 


Supervisor catalog failure 






0P87A** 


IPL failure 
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CANCEL CODES 



Figure 4.32. DOS/VS Cancel Codes and Messages, part 2 of 2. 

* If the CCB is not available, the logical unit is SYSxxx. 

** The cancel code is not significant in case of a supervisor catalog or IPL failure, because 
the system is placed in the wait state without any further processing by the Terminator. 

Note: In addition to recognizing the cancel codes above, the Terminator also recognizes the 
same codes with the X'80' bit on (cancel occurred in L TA). The X'80' bit is tested by 
$$BEOJ and subsequently reset. 



Debugging for Programmers, part 2. . 4.95 



Section 4, Chapter 9 

GENERAL PURPOSE 
REGISTER USAGE 



The following paragraphs describe the general usage of registers 0, 1, 13, 14, and 15 
by IOCS, but the description is not meant to be all-inclusive. 

Registers and 1 : Logical IOCS macros, the supervisor macros, and other IBM- 
supplied macros use these registers to pass parameters. Therefore, these registers 
may be used without restriction only for immediate computations, where the 
contents of the register are no longer needed after the computation. If you use them, 
however, you must either save their contents yourself (and reload them later) or 
finish with them before IOCS uses these registers. 

Register 13: Control program subroutines, including logical IOCS, use this register 
as a pointer to a 72-byte doubleword-aligned save area. When using the CALL, 
SAVE, or RETURN macros, you can set the address of the save area at the beginning 
of each program phase, and leave it unchanged thereafter. However, when sharing 
a reenterable (read only) logic module among tasks, each time that module is 
entered by another task, register 13 must contain the address of another 72-byte 
save area to be used by that logic module. 

Registers 14 and 15: Logical IOCS uses these two registers for linkage. Register 14 
contains the return address (to the program) from DTF routines, called programs, 
and your subroutines. Register 15 contains the entry point into these routines, and 
is used as a base register by the OPEN (R), CLOSE (R), and certain DTF macros. 
IOCS does not save the contents of these registers before using them. If you use 
these registers you either save their contents yourself (and reload them later) or 
finish with them before IOCS uses them. 



Registers for Your Use 

Registers 2-12 are available for general usage. There are, however, a few restrictions. 

The assembler instruction for translate and test (TRT) makes special use of 
register 2. It is your responsibility to save the contents of this register before 
executing the TRT instruction if register 2 contains valuable information (such as 
pointers or counters) for later use in your program. After the TRT instruction has 
been executed, you can then restore the contents of register 2 from the save area. 

If an ISMOD logic module precedes a USING statement or follows your program, 
the use of registers 2-12 remains unrestricted even at assembly time. However, if 
the ISMOD logic module lies within the problem program, you should issue the 
same USING statement (which was issued before the logic module) directly follow- 
ing the logic module. This action is necessary because the ISMOD logic module 
uses registers 1, 2, and 3 as base registers, and the ISMOD CORDATA logic module 
uses registers 1, 2, 3, and 5 as base registers. Each time either module is assembled, 
these registers are dropped. 
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Register usage by JOB ACCOUNTING GENERAL PURPOSE 

REGISTER USAGE 

(The Job Accounting option is discussed in Chapter 13 of this Section) 

The system passes registers 1 1-15 to the user's I/O routine ($JOBACCT). These 
registers contain the following information: 

• Register 1 1 : Length of the job accounting table. Each table may vary in 
length according to the number of SIO counts specified at system generation 
time. 

• Register 12: Base register for $JOBACCT (this eliminates the need for the 
user to load the base register) 

• Register 13: Address of the user save area 

• Register 14: Link register ($JOBACCT must exit via BR 14 to return to 
job control) 

• Register 15: Address of the partition's job accounting table. 

Because some of the job step information is cleared in the step-to-step transition, 
job control calls $JOBACCT at the end of each step. If $JOBACCT does not save 
or accumulate this information, it is lost. 

Register usage by POWER 

Register 2: linkage register for POWER subroutines; also used as a base for the 

Data Unit Table. 
Register 4: address of the Device Control Table. 
Register 6: base register for readers, writers, and the operator communications 

task command processor phases. 
Register 7: Address of the TIB of the task currently controlling the CPU 
Register 8, 9, 10 and 13: Base registers for the resident POWER code 
Register 14: I/O bugger address 
Register 15: Pointer to disk address for QFILE and Data File I/O 

Register usage by POWER RJE 

Register 1 : Pointer to RJE task DECB (DSKIO or GETBUF etc) 

Register 2: Subroutine linkage 

Register 4: Base register for BTAM Interface Module 

Register 6: Base register for RJE overlay phase 

Register 7: RJE task TIB address 

Register 8: 

Register 9: 

Register 10: 

Register 13: 

Register 1 1 : Subroutine linkage 

Register 14: I/O Buffer address 

Register 15: Pointer to disk address for QFILE and DATAFILE I/O or linkage 

register for BTAM 
Register 5: 



FGPSPOOL CSECT base registers 



Register 12: 



Work registers 
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GENERAL PURPOSE 
REGISTER USAGE 



Linkage Registers 

To standardize branching and linking, registers are assigned specific roles (Figure 
4.33). Registers 0, 1, 13, 14, and 15, are known as the linkage registers. Before a 
branch to another routine, the calling program is responsible for the following 
calling sequence: 

1 . Loading register 13 with the address of a register save area in the program 
that the called program is to use 

2. Loading register 14 with the address to which the called program will return 
control 

3. Loading register 15 with the address from which the called program will 
take control 

4. Loading registers and 1 with parameters, or loading register 1 with the 
address of a parameter list. (Although permissible, it is not normal to load 
register with parameters). 



Register 
Number 


Register Name 


Contents 





Parameter register 


Parameters to be passed to the called 
program. 


1 


Parameter register 

or 

Parameter list 
register 


Parameters to be passed to the called 
program. 

Address of a parameter list to be 
passed to either the control program 
or a user's subprogram. 


13 


Save area register 


Address of the register save area to be 
used by the called program. 


14 


Return register 


Address of the location in the calling 
program to which control should be 
returned after execution of the 
called program. 


15 


Entry point register 


Address of the entry point in the 
called program. 



Figure 4.33 Linkage Registers 



After execution of the calling sequence, the following should occur as a result of 
called program execution: 



The contents of registers 2 through 14, and the program mask are unchanged. 
The contents of registers 0, 1 and 15, the contents of the floating point 
registers, and the condition mode may be changed. 
The parameter list addresses contain the results obtained by the execution 
of the called program. 
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When support is provided during system generation for user exit routines (other TABLES REQUI RED BY 

than VSAM exit routines), an area is reserved in the supervisor for one or more of USER EXIT ROUTINES 

the following tables: 

• Interval timer (IT) 

• Abnormal termination (AB) 

• Page fault handling overlap (PHO) 

• Program check (PC) 

• Operator communication (OC). 

Entries in the table are generated from the STXIT macro issued by the problem 
program, and the number of entries depends on the number of partitions for 
which the system has been generated. 

The number of entries for the PC and AB tables is increased by the number of 
subtasks allowed on a system generated for use with multitasking. 
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TABLES REQUIRED BY 
USER EXIT ROUTINES 



Interval Timer Support (IT) 

This parameter generates programming support for the hardware interval timer 
feature, which is used to time-stamp the system. It enables a problem program to 
set a time interval (via the SETIME macro). 

By using the STXIT, EXIT, and TECB macros, a specific routine within the problem 
program or task is entered when this time interval elapses. 

How to locate the IT option table 

Bytes X'66'-X'67' of the partition communication regions contain the address of 
the IT Option Table. Label ITTAB identifies the first byte of the table. 



ITTAB 



See 
Note 



< 



V 



BG 



F4 



:P3; 



F2 



F1 



Subtask 



Subtask 



Subtask 







34 



TECB' 



Save Area 



/ 



Address 

i 



Compl. of T ECB 
Save Area, 



Address 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



/ 



/ 



\ 



\ 



\ 



/ 






\ 


Bytes 0-3: 


No TECB or STXIT 








issued 


zero 






TECB issued 


Address of the timer event control block 






STXIT issued 


Address of user interval timer routine 






STXIT issued and 








user routine is 








already in use 


Complement of the user interval timer routine 




Bytes 4-7: 


No TECB or STXIT 








issued 


zero 






TECB issued 


Complement of the TECB address 






STXIT issued 


Address of the user save area 





Note: One table entry is built for each partition and an IT Request table is also built. 

With multiple timer and asynchronous processing supported, the table always 
comprises 15 entries; the subtask entries occupy the higher address locations 
in the table. 



Figure 4.34. Explanation of the contents of the IT option table. 
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Interval Timer Request Table 

This table is generated only for systems supporting the interval timer option 
(IT= YES). It is used in conjunction with the IT option table described in 
Figure 4.34. 

The number of entries is one more than the number of partitions supported, but 
with multiple timer and asynchronous processing supported, the table always 
comprises 16 entries. 
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TABLES REQUIRED BY 
USER EXIT ROUTINES 



How to locate the IT request table 

Bytes X'50'-X'53' of the System Communication region (SYSCOM) contain the 
address of the IT Request Table. Label ITREQ identifies the first byte of the 
table. 



ITREQ 



See . 
Note S 



1 



Task 
Identifier 



1 r 

Time Interval 



\ 



\ 



/ 



\ 



\ 



V 



00 FF 00 00 00 



/ 



\ 



/ 



\ 



\ 



/ 

/ 




\ 

\ 


Byte : 


No SETIME issued . 


X'OO', the last entry is always X'OO'. 




SETI ME issued 


PIK or TIK (X'10-X'FO') of the program or task 
that issued the SETIME macro. 


Bytes 1-4: 


No SETIME issued : 


Highest time interval possible (X'FFOOOOOQ'h 
The last entry is always X'FFOOOOOO'. 




SETIME issued 


Time interval that will elapse between the occurrence 
of the currently pending interrupt in SYSTIMER and 
the occurrence of the interrupt itself. The entries are 
in ascending order of magnitude, that is, the smallest 
interval appears first. 

The interval corresponding to the currently pending 
interrupt is in SYSTIMER (address X'50') and the 
key of the respective program or task is in TWTIMS. 



Figure 4.35. Explanation of the contents of the IT option request table. 
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TABLES REQUIRED BY 
USER EXIT ROUTINES 



Abnormal termination support (AB) 

Abnormal termination exits are available for main tasks and/or subtasks, allowing 
you to gain control before an abnormal condition removes the task from the 
system. For example, in the abnormal termination routine, you can close your 
files. This function is provided by the AB operand of the STXIT macro. See 
Supervisor and I/O Macros for detailed information on the format and use of the 
STXIT macro. 



How to locate: 

Bytes X'54'-X'57' of the System Communication region (SYSCOM) contain the 
address of the AB Option Table. Label ABTAB identifies the first byte of the 
table. 



ABTAB 



See 
Note ^ 



V. 



BG 



F4 



F3 



F1 



Subtask 



3 4 

1 1 1 

AB Routine Address 



-I L- 



1 1 1 

Save Area Address 

— i 1 1 



/ 



\ 



\ 



/ 



\ 



/ 



\ 



/ 



\ 



Subtask 



Subtask 



/ 



/ 



/ 



\ 



/ 



Bytes 0-3: No STXIT issued 

STXIT issued and 
rtnaddr parameter 
passed 



Bytes 4-7: 



No STXIT issued 
or no save area 
parameter passed 

STXIT issued and 
save area para- 
meter passed 



Zero. 



Address of entry point of user's abnormal termination 
routine. If AP (Asynchronous Processing) is supported 
the maintask and subtasks may have the same or 
different AB routines. When a subtask is ATTACHed 
after a STXIT AB macro has been issued by the 
maintask, the subtask will receive the AB routine 
address specified by the maintask only if the 
ATTACH macro for that subtask has the ABSAVE 
parameter specified. The subtask can override this 
by issuing its own STXIT AB macro. 



Zero. 



Address of a 72-byte save area used by the supervisor 
to store the interrupt status information and the 
contents of the general registers. (See Chapter 12.) 



Note: One table entry is generated for each partition supported. With asynchronous processing 
support, the table always comprises 15 entries; the subtask entries occupy the higher 
address locations in the table. 



Figure 4.36. Explanation of the contents of the AB option table. 
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Page Fault Handling Overlap Support (PHO) 

This option enables a user routine to continue processing during the time a page 
fault, occurring in the same task, is being handled, PHO=YES in the SUPVR 
supervisor generation macro reserves an area in the supervisor for the PHO option 
table. Entries are made in this table when the user program issues a SETPFA macro 
instruction. The SETPFA macro instruction is described in DOS/ VS Supervisor 
and I/O macros. If asynchronous processing (AP) is not supported, one entry is 
generated in the table for each partition supported by the system (NPARTS). If 
AP is supported, 15 entries are generated. 



TABLES REQUIRED BY 
USER EXIT ROUTINES 



How to locate: 

Label PFATAB in the supervisor listing identifies the first byte of this table. 



r 



See 
Note 



< 



\. 



PFATAB 



BG 



F4 



F3 



F1 



Subtask 



Subtask 



Subtask 



1 



3 4 



PHO 
Routine Address 



/ 



r_ 



Page Fault Information 



Flag Byte 



\ 



\ 



/ 



/ 



\ 



\ 



/ 



\ 



/ 



\ 



\ 



/ 



/ 



\ 



SETPFA issued 



Byte : Bit : 1= A page fault from the task is in the Page Queue Table. 

Bit 1 1= A page fault occuring in a supervisor service of the task is 

queued in the Page Queue Table. 

Bits 2-7: Unused. 

Bytes 1-3: Address of the user's page fault appendage routine. 

Bytes 4-7: Page fault information (for detailed layout see Page Queue Table). 

This information is stored here only when a page fault occurs in a supervisor 
service working for the task, while another page fault is queued for the 
task in the Page Queue Table; otherwise, zeros. 

NO SETPFA issued 

Bytes 0-7: Zeros. 



Note: One table entry is generated for each partition supported. With asynchronous processing 
support, the table always comprises 15 entries; the subtask entries occupy the higher 
address locations in the table. 

PFA TAB is only built ifPHO=YES was specified in the SUPVR macro at supervisor 
generation. 
Figure 4.37. Explanation of the contents of an entry in the PHO option table. 
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TABLES REQUIRED BY 
USER EXIT ROUTINES 



Program check support (PC) 

Program check (PC) support generates a PC table within the supervisor (see the 
Figure below). The address of a user program check routine is placed in the table 
via the STXIT macro issued by the problem program. If the STXIT PC linkage is 
established and a program check occurs within this program, the supervisor gives 
control to the user's routine instead of canceling the job being run in this partition. 
The support is extremely advantageous when using LIOCS. (For example, files can 
be closed before job termination.) If a program check occurs in a routine being 
executed from the logical transient area (LTA), only the task associated with that 
routine is abnormally terminated. 



In a multitasking environment each subtask and main task may have its own PC 
routine. A PC routine can be shared by more than one task within a partition. This 
can be done issuing a STXIT macro in each task with the same routine address but 
with separate save areas. To successfully share the same PC routine, it must be 
reenterable (capable of being used concurrently by two or more tasks). 



How to locate: 

Bytes X'64'— X'65' of the partition communication regions contain the address of 
the PC Option Table. Label PCTAB identifies the first byte of the table. 



PCTA8 



See 
Note*S 



BG 



F4 



F3 



mi 



F1 



Subtask 



V 



Subtask 



Subtask 



PC Routine Address 



Save Area Address 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



\ 



/ 

/ 




\ 


Bytes 0-3: 


No STXIT issued 


: Zero. 




STXIT issued 


: Address of the user Program Check Routine. 




STXIT issued and 






the user routine 






is already in use 


: Complement of user Program Check Routine address. 


Bytes 4-7: 


No STXIT issued 


: Zero. 




STXIT issued 


: Address of the user Save Area. 



Note: In a supervisor without multiprogramming support, there is only one entry (BG) in each 
generated table. With multiprogramming support, there is one entry for each partition 
supported. 

With asynchronous processing support, each generated table always comprises 15 entries; 
the subtask entries occupy the higher address locations in the table. 

Figure 4.38. Explanation of the contents of an entry in the PC option table. 



4.104 Debugging for Programmers, part 2. 



Operator communications support (OC) 

Operator Communications (OC) refers to the processing of an external interrupt 
by a problem program. In a multitasking environment, only the main task can 
communicate via the OC linkage. By specifying OC=YES, a table (OC option table) 
is generated within the supervisor (see Figure below). When the problem program 
issues the STXIT macro, the address of its external interrupt routine is moved to the 
OC option table. The user's routine is terminated by issuing the EXIT macro. When 
OC=YES is specified, support is available to all partitions. 
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TABLES REQUIRED BY 
USER EXIT ROUTINES 



How to locate: 

Bytes X'68'-X'69' of the partition communication regions contain the address of 
the OC Option Table. Label OCTAB identifies the first byte of the table. 



r 



See 
Note^ 



^ 



OCTAB 



BG 



F4 



F3 



F1 



Subtask 



Subtask 



Subtask 



3 4 

1 1 1 — 

OC Routine Address 

i i i 



1 1 1 

Save Area Address 

— i 1 i 



\ 



\ 



\ 



\ 



\ 



\ 



\ 



\ 



\ 



/ 




\ 


Bytes 0-3: 


No STXIT issued 


Zero. 




STXIT issued 


Address of the user Operator Communication 
Routine. 




STXIT issued and 






the user routine 






is already in use 


Complement of the user Operator Communication 
Routine 


Bytes 4-7: 


No STXIT issued 


Zero. 




STXIT issued : 


Address of the user Save Area. 



Note: In a supervisor without multiprogramming support, there is only one entry (BG) in each 
generated table. 

With multiprogramming support, there is one entry for each partition supported. 
With asynchronous processing support, each generated table always comprises 
15 entries; the subtask entries occupy the higher address locations in the table. 

Figure 4.39. Explanation of the contents of an entry in the OC option table. 
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SAVE AREAS 



Partition Save Areas and Label Save Areas 

Each partition contains a save area for program name, old program status word, 
and registers. 

Following the partition save area, each partition contains a label area for label 
processing if the LBLTYP statement is used. Both areas are at the low end of the 
partition. 

Save area length = 88 (dec) bytes or, if the floating point feature is supported, 
120 (dec) bytes (FP=YES specified in the CONFG system generation macro). 

Label area length is determined by the system according to the LBLTYP card 
specification: 

• TAPE (standard tape labels) = 80 bytes 

• NSD (nn) (nonsequential disk) = 84 bytes + 20 bytes per extent statement 

• Omitted = 0. 

Figure 4.41 (opposite) illustrates the location of the partition and label save areas 
in virtual storage for a system supporting multiprogramming. The figure below 
shows an example of a background program partition, save area as it is printed in a 
system dump. The programmers remarks on the figure indicate how the programmer 
used the save area during offline debugging. 



<ifk*££&n Ze6K&&W oooooo oooooooo 

HEX LENGTH IS 0000 ^"^ fSg^ Jjjl- $# i 

BO 07C8C1E2 C55C5C5C 147100000 00O4009EI&pAi618Ofif <?0O00O00 4004007A 0OQ4107A PHASE*** 

040020 07C8C1E2 C5SC5C5C 00061000 8004008C*; ffio040820.) .00061000 OOOO E430 OO00E4B2 PHASE*** U...O. 

040040 80000015 80000015 00060FFF 00042008* 1 (0000JB490 B9825808 00000 000 00000000 H 

0400(0 00000000 OOOOOOOO OOOOOOOO OOOOOOOO Iffeo OOOOOO OOOOOO QO J05BO| 41CB 0FFF41CC 

BUGPRGCK 12/06/73 J>X Q-fdoA OC 3 ] ^*(*^fn/'J PAGE 51 

040080 00010700 4110C07E 4500B022 00040808 00040910 00040820 00040940 [OAO 3581 Q 

0400A0 C0AE4100 006B58F1 001005EF 5820CDB2 5830CDB6 5840CDBA 5850C0B2 5860C0B2 1 C...... 

0400CO 5870C0B2 5880C0B2 5890C0B2 47F0B00C 5810C0BE 58F10010 45EF0008 955CB8E6 .1 +.*(£x11Kt\ 



Figure 4.40. An example of a system dump output showing the partition save area. 

The programmer's remarks on the dump show areas of immediate interest during 
offline debugging. 



How to locate: 

The addresses of the partition save areas are stored in the problem program PIB, 
described in Chapter 7 in this Section. 
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BG 



FG 



SPVR <, 



> 



< 



> 



Supervisor Area 



-< 



Label save area. (See note 1 ). 



Background program area. 



Label save area. (See note 1). 



Foreground program area. 



V 









*W 



V /> A* 



^ 



& 




Other foreground program save areas, 



label save areas. 



and program areas have 
similar layouts. 



V 



o" 
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Program name (8 bytes) 



Return PSW (8 bytes) 



General Registers 

9 through 8 (64 bytes) 



Length of Label Area (2 bytes) 
See note 4 



Reserved (6 bytes) See note 2 



Floating Point Registers 
32 bytes 
(See note 3) 



Program name (8 bytes) 



Return PSW (8 bytes) 



General Registers 9 through 8 
64 bytes 



Length of Label Area (2 bytes) 
1 See note 4 



Reserved (6 bytes) See note 2. 



Floating Point Registers 
32 bytes 
See note 3. 



Note 1: Length of the label area depends on the amount of storage specified by L BL TYP 
statement: 

A. For standard tape labels (any number)-80 Bytes 

B. For sequential DASD and D TFPH MOUNTED SINGL E-0 Bytes 

.C. For DTFIS, DTFDA and DTFPH MOUNTED ALL-84 Bytes plus 20 Bytes 
per extent. 
Note 2: Job start time, for time stamp, is stored in last 4 bytes of this area. 
Note 3: Floating point register save area is required only when floating point feature is 

specified at supervisor generation. 
Note 4: Only non-zero if a // LBL TYP statement read before the current job step. Otherwise 
reserved by the linkage editor, but not entered in these bytes. 

Figure 4.41. Organization of partition save and label save areas. 
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ABSAVE area 

In all abnormal termination conditions where an exit is taken to an abnormal 
termination routine specified and written by the user, the register values are stored 
in the ABSAVE save area before the appropriate error code is stored in the low- 
order byte of register 0. To have this value available when looking at a storage 
dump you should store (STC or ST) register in another save area upon entry into 
the abnormal termination routine. You will find that the SVC code shown in the 
"0S04I ILLEGAL SVC- ..." message along with the error codes in register 
will be helpful in tracing program errors. Each user exit routine must have its own 
save area in order to preserve the contents of the 16 general registers and interrupt 
status information at the time the exit routine is entered. The address of the save 
area is specified in the STXIT macro and is contained in the appropriate option 
table. 

Figure 4.42 (opposite) illustrates the format and contents of the Interrupt Status 
Information (the first 8 bytes of the save area). Details about the STXIT macro 
can be found in DOS '/VS Supervisor and I/O macros, and details about the option 
tab les in the DOS/ VS Supervisor Logic. 
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rxu 



r -\ 


IT 


PC 


-< AB 

L 0C J 



Exit Routine 




Routine 
address 



Save area 
address 



General 

Registers 

0-15 



X'48' byte save area 
for user exit routines 
IT, PC, AB, OC. 
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Reserved 


Key 


1 

MWP 


I Interruption Code 


ILC 


CC 


Program 
Mark 


Instruction Address 



Always 
X'00' 



t 12 is always set to 1 

it 13 if set to 1 , enables machine check interrupt 
t 14 if set to 1 , indicates CPU wait state, 
t 15 if set to 1 , indicates CPU in problem state 
if set to 0, indicates CPU in supervisor state 



Interrupt codes , 
for PC: \ 



Interrupt code 
for IT: 

Interrupt codes 
for OC: 



X'01' 
X'02' 
X'03' 
X'04' 
X'05' 
X'06' 
X*07' 
X'08' 
X'09' 
X'OA' 
X'OB' 
X'OC 
X'OD' 
X'OE' 
X'OF' 
X'10' 

x'ir 

X'12' 
X'13' 
X'40' 
X'8x' 

X'80' 

X'40' 



Cause of Program 
Interrupt 

00000001 Operation 

00000010 Privileged operation 

0000001 1 Execute 

00000100 Protection 

00000101 Addressing 

000001 1 Specification 

000001 1 1 Data 

00001000 Fixed point overflow 

00001001 Fixed point divide 

0000 1010 De ci ma I o verf low 

00001 01 1 Decimal divide 

00001 1 00 Exponent overflow 

00001101 Exponent underflow 

00001110 Significance 

00001111 Floating-point divide 

00010000 Segment translation 

00010001 Page translation 

00010010 Translation specification exception 

00010011 Special operation exception 
01000000 Monitor call 

1 xxxxxxx PER event, where x = code 

for cause of program 

10000000 Timer check. For example, a 

PER + a data exception 

01000000 External = X'87' (10000111). 



Figure 4.42. The format and contents of the user exit routine save area and 

interrupt status information. 
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There are occasions when task information must be saved by the page manager. 
For example, page faults may occur when supervisor services are executed under 
control of user PIBs. Because the user's partition save area is occupied during this 
time, an additional system save area for each user task is provided. 

The information saves is contained in a 72-byte (dec) field, and includes the return 
PSW and 1 6 general purpose registers belonging to the interrupt supervisor task. 
The registers are stored in numerical sequence beginning with GR9. The save areas 
for all tasks (maximum of 15), are within the supervisor area. The address of each 
user task save area is recorded in the program information block. (Refer to Chapter 
7 in this Section.) 

Immediately following each save area is an area reserved for the CCW/TCB (Channel 
Command Word/Translation Control Block), the format and contents of which is 
described in Chapter 13 in this Section. The addresses of system (task) save areas 
are contained in the system communication region, refer to Chapter 2 in this 
Section. 
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Save Areas for the Job Accounting option 

If the JALIOCS parameter is specified in the FOPT supervisor generation macro, 
two save areas are reserved in the supervisor. 



JALIOCS= 



NO indicates that no special LIOCS support is required. Specification of (s, 1) 
indicates that a user save area and a label area are to be reserved. 

S is the decimal number of bytes to be reserved for the user save area (located in 
the supervisor). This save area may be used to save DTF information or for any 
other purpose desired by the user. The system does not access this area. (The 
address of the save area is available in register 13 when fcJOBACCT is called.) 
The valid range of s is 0-1024, with a default of 16. 1 is the decimal number of 
bytes needed for a label area. This label area replaces the one normally used by 
LIOCS label processing. It is required when $JOBACCT uses LIOCS for such 
things as standard tape labels, DTFDA, and DTFPH with MOUNTED=ALL. The 
valid range of 1 is 0-224, with a default of zero. The value that is substituted for 
1 is normally the number of bytes that would be allocated by a given parameter 
on the LBLTYP statement. See Figure 4.41 in this Section to determine 
the number of bytes allocated for any given LBLTYP statement. 

If the JA parameter is specified and JALIOCS is not the job accounting interface is 
generated but no alternate label area is reserved (16 bytes are reserved for the 
save area). The routine $JOBACCT must then use a device or method that does 
not require LIOCS label programming. If the JA parameter is not specified, the 
JALIOCS parameter is ignored. 
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PAGE MANAGEMENT 
TABLES 



The purpose of this chapter is to describe the tables that are used by the page 
management routines which may need to be inspected during program debugging. 
A knowledge of the concept of virtual storage is assumed. 



The Segment Table 

One segment table is generated within the supervisor area during system generation. 
Each entry in the segment table corresponds to one 64K segment of virtual storage. 



How to locate: 

The address of the first entry in the segment table is contained in bytes X'DO' to 
X'D3' of SYSCOM. Label STAB in the supervisor listing identifies the address of 
the first byte of the segment table. The address of the segment table is also 
contained in control register 1. Refer to the example shown in Figure 4.47. 



The Page Table 

One page table is generated for each segment of virtual storage during system 
generation. Each page table is 64 (decimal) bytes in length, and has 32 two-byte 
entries. Each entry corresponds to 2048 (decimal) bytes of virtual storage. As 
illustrated in Figure 4.46, the page tables occupy a consecutive area in the 
supervisor. 



Initialization of the Page Table 

After IPL, page table entries are initialized as follows: 

• All page table entries belonging to the supervisor area (nucleus and 
transient areas): 

Bit 13 = 

Bit 15 = 

Bits 0- 12 = the leftmost 13 bits of the address of the corresponding 

page frame. 

• All page table entries for allocated real partitions: 
Bit 13 = 

Bit 15=1 
Bit = 1 
Bits 8-11= storage key of the partition. 

• Page table entries belonging to virtual partitions: 
Bit 13= 1 

Bit 15 = 1 
Bit 0=0 
Bits 8-11 = storage key of corresponding partition. 

• All remaining page table entries: 
Bit 13 = 

Bit 15 = 1 
Bit 0=1 
Bits 1-12 = 
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How to locate 

The address of the page table belonging to the first 64K of virtual storage is 
contained in the first entry in the segment table. 

The address of the page table belonging to subsequent segments of virtual storage 
are contained in the associated segment table. Refer to Figure 4.46 which illustrates 
this. 

Appendix G shows an example of locating the segment table and page table in a 
dump. 

Figure 4.43 (below) shows the format and contents of an entry in the segment 
table and an entry in the page table. The figure also illustrates the interconnection 
between these two tables. 



STAB (Segment table) 



Each entry in the 
segment table 
corresponds to one 
64 K segment of 
virtual storage. 

One page table is 
built for each seg- 
ment of virtual 
storage and W 

contains 32 two-byte 
entries. 



PT (Page Table) 







1 



PAGE MANAGEMENT 
TABLES 



Bytes and 1 


: BitO 


1= Address of any byte in the corresponding page 
is invalid, that is the page is not in real storage 




Bits 0-1 2 


Leftmost 1 3 bits of address of page in real storage 
if bit 1 3=0. 




Bits 8-1 1 


Storage key of corresponding partition if bit 13= 1 . 




Bit 13 


= Page is in real storage; 

1 = Page is not in real storage. 




Bit 14 


Always zero. 




Bit 15 


= Page must be read from page data set, (a valid 
copy of the page is on SYSVIS); 

1 = Page need not be read from page data set, (there 
is not a valid copy of the page on SYSVIS). 



Note: Label STAB identifies the first byte of the table 

Label PT identifies the first byte of the Page Table. 

Figure 4.43. Explanation of the contents of an entry in the Page Table. 

This figure also illustrates the relationship between the page table and the segment table. 
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TABLES 



Page Frame Tablje 

The page frame table is built at supervisor generation time and contains one 8-byte 
entry for each 2K block of real storage (page frame) as specified in the RSIZE 
parameter of the VSTAB macro. 



How to locate: 

Bytes X'D4-X'D7' of the SYSCOM contain the address of the first entry in this 
table. Label PFT in the supervisor listing identifies the address of the first byte 
of this table. 

The format and contents of an entry in the page frame table is shown below. 






1 


2 


3 


4 


5 


6 


7 



\ 



\ 



\ 



\ 



\ 



Bytes and 1 : 



Bits 0-10 
Bit 11 
Bit 12 
Bit 13 
Bit 14 
Bit 15 



Counter for temporary fixes (tfix counter.) 

Reserved for later use. 

1= PFIX request (into another page frame) pending for the page . 

If on, page frame is unusable (hardware failure). ^7^ -A 5 ? % < T 

If 0, page frame belongs to selection pool j^"P \\ n 

1= PFIX (different page) or GETREAL request pending for the page frame. 



Bytes 2 and 3: Pointer to next page frame in queue or to queue header if last element 
in the queue (all page frames in selection pool are queued). 

Bytes 4 and 5: If the frame is occupied, the page number (The virtual address of the 
page divided by 2048); if unused, X'FFFF'. 

Bytes 6 and 7: Pointer to the previous frame in the queue or to queue header if first 

element in the queue (all page frames in the selection pool are queued). 



Figure 4.44. Explanation of the contents of an entry in the Page Frame Table. 

Page frame table extention (PFTX) 

This table is a one-byte appendage to each entry in the page frame table. It serves 
as a counter for the number of times a page has been permanently fixed in a page 
frame, and is labeled PFIX counter. 

How to locate 

Bytes X'D8' - X'DB' of SYSCOM contain the address of the first entry in this 
table. Label PFTX in the supervisor listing identifies the address of the first byte 
of this table. 
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Boundary Box 

This information block is generated in the supervisor during system generation. 
The area occupied by the boundary box is sufficient to contain up to six entries, 
depending on the number of partitions specified during system generation. The 
first entry contains information about virtual storage allocation, and the remaining 
entries contain information pertaining to each partition supported by the supervisor. 
If a partition is not supported by the supervisor, the beginning and end addresses 
are identical to those of the next partition. 
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How to locate: 

Bytes X'DC - - X'DF' of SYSCOM contain the address of the first entry in this 
information block. Label BBOX in the supervisor listing identifies the address of 
the first byte of this information block. Appendix G shows an example of locating 
the boundary box in a dump. 

The format and contents of the boundary box is shown below: 



3 


4 5 


6 7 


8 11 


12 


15 


End Address of Real Storage 


Number of 


Number of 








or Address of Alternate Area 


Page Frames 


Page Frames 


Begin Address of Virtual 


End Address of Virtual 




for PDAID or the start 


in smallest 


in Main Page 


Address Area 


Address Area + 1 




of the SD area for SDAID 


Real Partition 


Pool 









Format of the 
General Entry 



BBOX 


General Entry 






BG Entry ^ 






F4 Entry 




F3 Entry 




F2 Entry 




F1 Entry 



> 



The number of entries is equal 

to the number of partitions (NPARTS) 

specified at system generation + 1 . 



Format of 
any entry 



-— - — 3 


4 7 


8 11 


12 ~~~~ ■ — - 


-J5 


Begin Address of 
Real Partition 


End Address of 
Real Partition + } 


Begin Address of 
Virtual Partition 


End Address of 
Virtual Partition + 1 


These values are inserted at IPL tir 
by ALLOCR command. 


ne but can be changed 


These values are inserted at systen 
be changed by the ALLOC comm 


n generation time but can 
and. 





Note: The begin and end address fields for a partition that is not allocated contain the begin and end addresses of the following partition. 
Figure 4.45. Explanation of the contents of the Boundary Box 
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PAGE MANAGEMENT Converting virtual to real addresses and vice-versa 

TABLES 

There are several methods of calculating real addresses from virtual and vice versa. 

One method is given below. 

(The values assumed in the examples apply to the illustration opposite.) 

A. Converting a virtual address to real: 

1. Write the hexadecimal virtual address in binary. For example (assuming 
a virtual address of 1FA20), 

^\ F A20 ^___^ 

0001 1111 1010 0010 0000 

2. Ignore the ten rightmost bits. For the example, this leaves 

0001 1111 10 

3 . If after step 2 the rightmost bit is a 1 , change it to a 0; if it is a 0, 
leave it 0. 

4. Convert the binary value obtained in step 3 to hexadecimal. 
For example, 

0001 1111 10 
1 j— 

7 E 

5. Locate the address of the page table, contained in the first entry of 
the segment table, the address of which is contained in CR1. (For 
example shown opposite, this is 6A28,) 

6. Add the address of the page table to the hexadecimal number obtained 
in step 4. 

For example, 

6A28 

+ _ZE 

= 6AA6 (This is the address of the entry in the page 
table associated with the virtual address to be 
converted to real. ) 

7. Locate the page table entry in the dump. 

8. Replace the right most bit of the contents of the page table entry 
by a 0. 

For example, as shown in the illustration opposite, the page table 
at address 6AA6 contains 01B9. The right most bit is a 1 (X'9' = 
1001.) 

9. After replacing the right most bit by a 0, convert the resulting four-bit 
binary string to hexadecimal. 

For the example, 1000 - X'8'. 

The value thus obtained in this example is 01B8. 

10. Increase the value obtained in step 9 by attaching two 0s to the right. 

For example, 01 B800 (This number is the address in real storage 

of the lower limit of the page frame in which 
the real address is located.) 

1 1 . Convert the eleven rightmost bits of the binary value obtained in step 1 
to hexadecimal. 

For example, 

010 0010 0000 

1 — — 1 — —I — 

2 2 

12. Add the value obtained in step 1 1 to the number obtained in step 10. 

For example, 

01B800 
+ 220 

01 B A20 (This is the real address. ) 
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Bytes X'D0-D3' of SYSCOM 

and 

Control register 1 

contain the address 
of the segment table. 



00006C80 



Page table 

Each entry represents Real address area 

2048 (dec) bytes of If the invalid-bit of the 

virtual storage. There page table entry is 

are 32 entries in set (=1 ), the page 

the page table for each resides in the real address 

entry in the segment area. 

table 



Segment table 
Each entry 
represents 
64K (dec) 
of virtual 
storage. 




0000 



0008 
0010 



\ 

\ ' 
\ 



\ \ 



0000 00 



00 08 00 



00 10 00 



01 B0 00 



01 B8 00 



01 CO 00 



3F 00 00 



3F7F FF 



Page frame table 

Each entry represents 2048 (dec) 
bytes of the real address area, and 
indicates the status of the 
attached page. 
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/ 
/ 

/ / 



// 



00 3F 



Page frames 
^ allocated to 
the supervisor 



Page frames 
allocated to 
'' partitions running 
in real mode 



Page frames 
?~ allocated to 
the page pool 



y 



End of real storage 



Explanation of the illustration. 

The segment table in this example starts at address 6C80. 

The page table starts at address 6A28. 

Three valid entries in the page table are shown allocated to three consecutive 

2K slots in the real address area. (The associated entries in the page frame 

table are indicated.) 

The page entry at address 6AA6 contains a value of 01 B9 which is used in the 

example given on the opposite page. 

Figure 4.46 illustrates the relationship between the page management 
tables that are described in this chapter. 
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PAGE MANAGEMENT Converting a real address to virtual: 

TABLES 



1 . Write the hexadecimal real address in binary. For example, 
/01BA20£ 

J. A. 



0000 0001 1011 1010 0010 0000 

2. Ignore the eleven rightmost bits. Thus, for the example, 

0000 0001 1011 1 is the remaining binary number. 

3. Add three 0s to the right of the binary number obtained in step 2. 

Thus 

0000 0001 1011 1000 

4. Convert this binary value to hexadecimal. 

For example, 

0000 0001 1011 1000 

n r T~ ~r- 

1 B 8 

5. Add the number obtained in step 4 to the address of the page frame 
table. Bytes X'D4' - X'D7' of SYSCOM contain the address of the 
page frame table. (For the example, this is assumed to be 6100.) 

For example, 

6100 

+ 1B8 

= 62 B8 

6. Locate this address in the dump. (This is the address of the page frame 
table entry associated with the real address to be converted.) 

7. Locate bytes 4 and 5 of this page frame table entry. (For the example, 
as illustrated in Figure 4.46, a value of 003F is assumed.) 

8. Write this hexadecimal number in binary. 

Thus for the example, 

0000 0000 0011 1111 

9. Ignore the leftmost three bits, and add three 0s to the right hand end 
of the resulting binary string. 

Thus, 

0000 0001 1111 1000 

~i r~ — r ~ -r 

1 F 8 

1 1 . Convert the eleven rightmost bits of the real address (as written in 
binary in step 1) to hexadecimal. 
For example, 

010 0010 0000 



2 2 

12. Add the number obtained in step 10 to the number obtained in step 1 1 
For example, 

01F800 
+ 220 



= 01FA20 (This is the virtual address.) 
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EVENT PGM CHK INTERRUPT TOO MICSEC 
GPR 0-7 0000001B 000*0910 00000021 
00000000 00000000 00000000 
00*OOOFF(OOOOE6*6)FFFFFFFF 
OOOOFFFF "" 



GPR 8-F 

CTL 0-T 

CTL 8-F 

LOW CORE 

00000000 

00000020 

000000*0 

00000060 

00000080 

OOOOOOAO 

OOOOOOCO 



00000000 
*7100000 
1000E7F0 

socoooo 
C000005* 

000000 Oi 






2333009*58490780 PSM AT TIME OF EVENT *710300000<j*07l|) INSTR DE03C676C5EC 

00000003 0000002E 00000000 00000000 00000000 ■ 

l,nninmt nnm. 1 *-»« r,-.r 8c i E2 A00*06EE 000*22AO 

JOOOOO 00000000 00000000 

JOOOOO C2000000 00000200 



020007 
00000000 20000060 
00000000V00000000 00000000 
SAME- 



acM/*, COMAE<f- h JqVaq) 4000000Q 00000000 

J3E"fT* *70C2000 0000090C 

500000 F25BBC00 01AAAB17 **0C00OO 00000C1* 
0*080000 O00OD13A **0C0000 00000810 
120*2003 00020000 00000000 000001CC 
00000000 00000100 OOOOOOOE 00000000 
00000000 00000000 00000000 00000000 



SYSCOM 



SUPERVISOR 

00000120^60000000 

—SAME 
00000*A0 F1F261F0 

00000*C0 00060FFF 0UU*^3i!H 000*2 32F 00000010 

00000*EO *10**296 *297*389 3F003F06 3F0C38F1 

00000500 *6300000 3DCC3E*C 3EBC0010 OOOOOOOC 

00000520 OOOOOOOO 0*A010E0 00000588 C0CC03*0 

D00005*0) 1000061*0 00662EC4 08fl*(57Cfl flOflfl*11* 

00017C00 020050E6 00J2002C 00050000 

00000580 608r0800 000C08FC 00009260 000O5F78 

000005AO 00000000 00007998 00006360 

000005CO 0000A5E2 00009710 C00006HC 

000005EO 00081018 00200000 00000000 

00000600 0P300010 00000000 cooooooc 

00000620 |000063D8 O00000O0 00000)00 






/{owe*) 0/ 



*0*>..-.. 

06oo56C*/ 



FFOC 



100 






\5y5C0M 

\y///j'.'.'.'a'.'.'.'.'.'.'.'.'.Y.'.'.'. '. '. (£* 194 #r) I 



*dS 



00000E60 
00O0DE80 
OOOODEAO 
OOOODECO 
OOOOOEEO 
OOOOOFOO 
00OODF2O 
000ODF*0 
0O0ODF60 
OO0OOF80 
OOOOOFAO 
OOOOOFCO 
OOOOOFEO 
OOOOEOOO 
0000E020 
O0O0E0*O 
OOOOE060 
000 OE 080 
OOOOEOAO 
OOOOEOCO 
OOOOEOEO 
OOOOEIOO 
0000E120 
OOOOE1*0 
0000E160 
OOOOE180 
O0O0E1AO 
0000E1C0 
0000E1E0 
0000E200 
O0O0E220 
OOO0E2*0 
OOO0E260 
O0O0E28O 
OOO0E2A0 
O0OOE2CO 

00O0E320 
0000E3*0 
0O00E36O 
OO00E380 
0OOOE3A0 
O00OE3CO 
OO00E3E0 
OOOOE*00 
0OOOE*2O 
O000E**0 

OO0OE*AO 
0O0OE*CO 

0000E500 
O00OE52O 
0000E5*0 
0000E560 

0000E5A0 
0OOOE5C0 

0000E620 
OOOOE6*0 
0000E660 
OOOOE680 



00000000 
00000000 
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Figure 4.47. An example of an SDAID "dump on program check" showing how 
to locate the page management tables. 
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Channel program translation 

This chapter describes the control blocks used by the DOS/VS channel program 
translation routines, which may require examination under certain circumstances 
of a system malfunction. 



I/O operations and of virtual storage 

For a full description of the channel program translation routine, refer to the 
DOS/VS Supervisor Logic manual. 



General functions 

Because the DAT (dynamic address translation) feature is not available for data 
and channel command words of I/O operations, software routines are required that 
perform the following functions for an I/O request from a virtual partition: 

1. The CCB and, if applicable, the user sense CCW will be copied into a buffer. This 
buffer is called the CCB copy block and is maintained by the CCW-translation 
buffer management. 

If a second I/O operation from a virtual partition is requested, the copied and 
translated CCB is queued behind the first request in the CCB copy block queue. 
Label ACCBB in the supervisor listing points to the address of the CCB copy 
block queue. Displacement X'44' from this address contains the address of the 
second CCB copy block. 

2. The complete channel program, consisting of one or more CCWs, will be copied 
into a buffer area called the CCW copy block. The copied channel program is 
logically equivalent to the original channel program, the data addresses being 
translated to real addresses. The copy process conserves the channel program 
structure, but TIC (transfer in channel) commands will be inserted in the copied 
channel program when there are more than seven CCWs in a channel program. 
Figure 4.51 shows a channel program having eleven CCWs; two copy blocks that 
are linked by a TIC command are therefore required. Figure 4.52 illustrates the 
format and contents of the CCW/TCB. 

3. Addresses in the copied channel program that refer to an I/O area in a virtual 
partition are translated into the corresponding real addresses. If the I/O area is 
completed on one page, the real address will replace the virtual address in the 
copied channel program. If the I/O area occupies more than one page (crosses 
page boundaries), an IDAL (Indirect Data Address List) block is built up. The 
IDAL block contains the real address of the I/O area and the real page addresses 
of any pages occupied by the I/O area. The address of the IDAL will replace 
the virtual address in the copied CCW, and the IDAL bit (bit 37 in the CCW) 
will be set to 1 . If the virtual channel program already uses the IDA feature, 
both the IDAL from the virtual partition copied and the virtual addresses will be 
replaced by the corresponding real addresses. 

Figure 4.48 illustrates the actions described in points 1, 2 and 3 above, and 
Figure 4.49 illustrates the relationship between the blocks described. 
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User- task 



EXCP 



Via dispatcher 



• Copy CCB 

• Copy CCWs 

• Translate copied CCB 

• Fix data areas 

• Build IDALS (if required) 

• Translate copied CCWs 

• Enqueue request to channel 
queue 

• Start I/O 



user-task 



Under PI K of usertask 
that requested I/O 



Via dispatcher 



• Move parts of copied CCB 
to original CCB 

• Release buffer of copied CCB 

• Reset indicator for moved 
CCB 



l/O-interrupt handler 



l/O-interrupt belonging to above 
mentioned l/O-request 

• (handle ERP) 

• Transfer interrupt information 
from CSW to copied CCB 

• Post CCB, post task dequeue 

• Request from channel queue 

• Retranslate CCW- address in 
copied CCB to virtual free 
data areas 

• Release copy buffers, except 
that of CCB 

• Set indicator and move CCB 
if necessary 



Under PI K of interrupted task 



Figure 4.48. Illustrates the activity between user program and supervisor during 
the handling of an I/O request from a program running in virtual 
mode. 
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Additional functions performed by the channel program translation routine are: 

4. A sense CCB (if applicable) is updated in the copied CCB. 

5. All I/O areas required by the channel program must remain in real storage until 
the I/O operation is complete. For this reason all pages involved with an I/O 
operation are fixed in real storage. 

After the above functions have been performed, the I/O request is handled as if it 
were a request from a real partition. The following supervisor activity then ensues: 

1. The request is placed in the channel queue. 

2. A START I/O is issued. 

3. The corresponding interrupts are processed. 

4. The ERPs are activated (error recovery procedures in case of I/O device errors). 

5. Status information is posted in the copied CCB. 

6. The request is removed from the channel queue. 

After completion of an I/O request from a virtual partition, the channel program 
translation routine translates the real command address (from the CSW) to the 
corresponding virtual address, frees all fixed pages that were required by the 
request, transfer parts of the copied CCB to the virtual CCB, and releases all areas 
used by the buffers required by the channel program translation routine. 

Figure 4.48 illustrates the complete operation described above under points 1 
through 5. 



IDAL block 

The IDAL block is generated by the CCW translation routine if the I/O area 
specified in a CCW crosses page boundaries. The IDAL blocks are placed in the 
buffer area at the end of the supervisor together with associated CCB and CCW 
copy blocks. Each block contains real addresses of the data areas in real storage. 
Because each address is 4 bytes in length, an IDAL block can contain up to 18 
addresses (also referred to as IDA words.) Each IDAL must be completely 
contained in one IDAL copy block. If more than one I/O request requires an IDAL, 
as many IDALs are placed in one IDAL copy block as will fit. 

The figure opposite shows the relationships between the blocks. 

Appendix G shows an example of locating a CCB copy block and CCW copy 
block in a stand-alone dump output. The CCB address in the channel queue is used 
as the initial pointer. 



CCB copy block 

CCB copy blocks are placed in a buffer area (specifically reserved for the channel 
program translation routine) at the end of the supervisor together with the 
associated CCW copy blocks and IDAL block (if required). Each CCW copy block 
consists of nine entries. The first seven entries are used to store copied CCWs, and 
the remaining two entries (16 bytes) contain pointers and end-of-buffer indicators. 
The format and contents of a CCW copy block is shown in Figure 4.50. 
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Figure 4.49. Illustrates the relationship between an original channel program in a 
virtual partition and the copy blocks required by the channel program 
translation routines. The input/output areas in real storage are also 
shown. 
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1 


2 


3 


4 


5 


6 


7 


CCBCNT 


CCB 
COM1 


CCB 
COM2 


CCB 
STA1 


CCB 
STA2 


CCB 
CLS* 


CCB 
LNO 


CCBCCW 

Address of first CCW 


CCBBY3 


CCBCSWW 


CCBSENS 
Sense CCW if any 


CCBPIK 
User PI K 


CCB 
FLAG ** 


Unused 


CCBVA 

Virtual Address of CCB 


CCBACB 

Address of first CCW copy block in 

channel program 


CCBICB 

Address of first I DAL block in channel 

program 


CCBXINF 


(Fix information; 24 bytes) 

Each bit in this field represents one page frame. 
If a bit is on, the associated page frame contains 
a page fixed for this I/O request. If more than 
384K of real storage are available, the address 
in CCBXPTR will point to any additional field 
which contains bits for the page frames beyond 384K. 












CCBXPTR 

Address of additional Fix information 


CCBNEXT 

Address of next CCB copy block 



Set to X'21 ' (= copied CCB) 



Legend CCB FLAG: Bit 
1 
2 
3 



1= Translation complete 

1= Pages fixed 

Not used 

1= BTAM Second Time Request (I/O request from 

BTAM appendage) 
4: Not used 
5: Not used 
6: Not used 



Field 



Description 



(16 bytes): Copied and updated CCB. 

(8 bytes): If a user sense CCW is available, the CCW will be copied into this area. If the sense I/O area crosses a page 
boundary, an IDAL will be generated and the address of the IDAL will replace the address in Sense CCW. 

(2 bytes): Contains the PIK-value of the virtual I/O requestor. This value will be used by the MOVECCB routine to 
identify the requestors CCBs. 

(4 bytes): Contains the virtual address of the original CCB. 

(4 bytes): Address of the first CCW copy block occupied by the real channel program. 

(4 bytes): Address of the first IDAL block of zero, if no IDAL is needed. 

(24 bytes = 128 bits): Contains the fix information for the I/O request (FIXINF). Each bit corresponds to a physical 
page frame. If a bit is one, the corresponding page is fixed for the current I/O request. The 1 28 bits are sufficient for 
a Relocate System with up to 384K bytes of real storage. 

(4 bytes): If real storage is greater than 384K, the FIXINF is logically continued in another copy block with 68 usable 
bytes corresponding to 1032K additional real memory. The address in H will point to the attached fix information 
field. For real storage not greater than 384K, the value of H will be zero. 

(4 bytes): Contains a chain pointer. All CCB copy blocks will be enqueued into a CCB Copy queue. CHAINPTR 
points to the next CCB copy block on the queue. If this copy block is the last one, CHAINPTR equals zero. The 
pointer ACCBB either will point to the first CCB copy block on this queue or is zero, if no CCB is copied. 



4.1 23 Figure 4.50. Explanation of the contents of a CCB copy block. 
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Channel Program without TIC or SEARCH Commands 

The CCWs in a channel program without TIC or SEARCH commands are copied 
into sequential locations in the CCW copy buffer. If the program has more than 
seven CCWs, a TIC is inserted in the eighth copying position and is made to point 
to the first CCW in the next copy buffer. CCWs 8 through 14 are then copied in 
the next copy buffer. If there are more than 14 CCWs, the process is repeated 
until all CCWs are copied. 

Refer to the DOS/VS Supervisor Logic manual for a full description of the CCW 
copy block when using TIC and SEARCH commands. 

Figure 4.51 (below) shows the copying of CCWs for a channel program requiring 
two CCW copy buffers. 
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VIRTUAL STORAGE 



REAL STORAGE 



Virtual Channel Program 



CCBNAME CCB SYSxxx, CCW1 



Copied CCB (See Figure 4.50). 



CCW2 


CCW 


CCW3 


CCW 


CCW4 


CCW 


CCW5 


CCW 


CCW6 


CCW 


CCW7 


CCW 


CCW8 


CCW 


CCW9 


CCW 


CCW10 


CCW 


CCW11 


CCW 




CCW Copy Block 1 
(See Figure 4.52) 



CCW Copy Block 2 
(See Figure 4.52) 



Legend: TIC 



Transfer in channel command 



ACCW8 = Address of CCW8 
ANB = Address of next CCW Copy Block 
VBA = Virtual Address of CCW1 (for Copy Block 1) and virtual 
address of CCW8 (for Copy Block 2). 

Figure 4.51 . A channel program requiring a TIC to be inserted in copying. 
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1st Copy location for CCW 



2nd Copy location for CCW 



3rd Copy location for CCW 



4th Copy location for CCW 



5th Copy location for CCW 



6th Copy location for CCW 



7th Copy location for CCW 



X'80'* 



X'000000' 



Virtual address of first CCW in the 
Copy block 



X'88 M 



X'000000' 



Address of next CCW Copy block in 
the chain 



* X'80' indicates the end of the CCW copy locations in the block. It is replaced by a TIC 
(Transfer in Channel command) if the 7th copy location contains a copied CCW with data- 
or command chaining. Bytes 57-59 will then point to the copy location of the CCW 
following the CCW in the 7th copy location. 
Bytes 56-59 will not be changed if the CCW in the 7th copy location is a TIC. 

** X'88' indicates the last 8-byte entry in the block. It is replaced by a TIC if the CCW in the 
7th copy location is a status modifier CCW. For example a SEARCH command to a disk. 
Bytes 65-67 will then point to the copy location of the second CCW following the status 
modifier CCW. 

Figure 4.52. Format and contents of a CCW copy block 
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Translation Control Block 

The routine CCWTRANS is called by the channel scheduler whenever a channel 
program must be copied and translated. Since a page fault may occur during 
CCWTRANS, the routine and its subroutines are reenterable and can therefore 
process several translation requests concurrently. In order to make CCWTRANS 
reenterable a translation control block (TCB) is built for each task to serve as a 
dynamic work and save area. Each TCB is located behind the special save area for 
its task and has the format shown in Figure 4.53. 

How to locate: 

To locate the TCB (associated with the partition/ task), add X'50' to the address of 
the System Save Area (displacement X'09' of the appropriate PIB). Labels 
CCWTCB1 - CCWTCBn identify the first byte of the appropriate TCB. 



Format 
of any TCB 

1 



3 4 



11 



12 15 



16 



19 20 



23 24 



27 



Flag 
byte 

* 


used 

by 

BTAM 


TIK/PIK 


Pointer to 
Status Modifier 
List 


Pointer to 
Control Com'd 
List 


Pointer to 
TIC line 


Pointer to 
Copy Block 
End 


Address of 
copied CCB 
(for cancel) 


Number of 
free IDA words 
in IDAL block 



28 



47 48 



51 



52 



107 108 



111 



Work Areas 


Address of 
last TF IX 
request 


Save Area 
(Registers 2-F) 


Pointer to 
next used 
TCB 



Byte 0: 


bit = 1 


data chaining specified 




1 =1 


: Read/Sense command specified 




2=1 


: Read backward command specified 




3=1 


: Status modifier command with data chaining 




4 = 1 


: Status modifier command only 




5 


: Reserved 




6 


: Reserved 




7 


: Reserved 



Note: One TCB is generated for each partition supported. 

With asynchronous processing support, 15 TCBs are generated. 

Figure 4.53. Explanation of the contents of the TCB. 
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Fix Information Blocks 

In order to keep track of which page frames have been TFIXed for a request, a bit 
string is used which has a bit for at least every page frame up to the highest one 
which is TFIXed. If no page is TFIXed in an address higher than 384K, then the bit 
string in CCBXINF is sufficient (192 bits = 384K). Whenever a page is TFIXed, the 
bit corresponding to its page frame is set to one. If a page is used more than once 
by a request, it is TFIXed only once. 

If a page is TFIXed at a location beyond 384K, one or more additional bit strings 
must be added. This is done by enqueuing a copy block. Each copy block thus 
enqueued provides fix information for an additional 1088K of real storage. The 
additional blocks are queued with the first one being pointed to by the field 
CCBXPTR in the CCB copy block. Figure 4.54 shows how fix information is kept. 



Fix-String: 

bit-table where each bit belongs 
unequivocally to a page frame 
(for 1038K bytes); if a bit is on, 
the page frame belonging to this 
bit has been TF IXed for this 
l/O-request. 

AIMB: 

—0 if Fix-block is last one in 
Fix-block queue, 
—address of next Fix-block. 



Fix-string 
of 544 bits 



+68 ANB 



Fix-bit string- 
represented — 
page frame 



01 



Li 



■CCBXINF- 



OK 



TFix(1) 



Fix-string 1- 



384 K 



Fix-string 2 



TFIX (2) 
384 K 
+1088K 



384 K 
+1088K 
+1088K 



• if for a specific page frame the Fix-bit is already on, noTFIX-request is transferred to the 
.page manager 

• the TFIX-blocks are freed after l/O-request has been posted complete 
F igure 4.54 Fix information Bit String and Block 



General Rules for channel program translation 

The following rules apply to IBM-supplied channel program translation routine 

1. Channel program translation is skipped: 

• for I/O requests from programs running in real mode 

• for I/O requests from system tasks (FETCH/LOAD has its own small CCW- 
translation.) 

• for I/O requests for console when console buffering option is supported 

2. Channel program translation is modified for BTAM running in virtual mode 
(modify CCW-chain from I/O appendages). 

3. The following components work via copied and translated CCW chains: 

• CRT 

• seek separation routine 

• ERPs 

• BTAM-ERPs 

4. Channel program translation does not support: 

• self-modifying channel programs 

• start of I/O requests from I/O appendages for not translated channel programs 
(except BTAM) 

• time dependent I/O requests (channel program may get longer after translation) 

• channel programs with CCWs whose count is 32K 

• channel programs with data chaining in connection with TIC -commands when 
the same CCW gets different command codes during execution of channel 
program. 
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Appendix A 

PD AREA TABLES 





Byte 



4 

8 

12 

16 

20 

24 

28 

32 

36 






PDAREA 


PDAREAND 






PDINTRHK 






PDSIQHK 






PDTRANHK 






PDFLTHK1 






PDFLTHK2 










PDREGSAV 















— Address of end of PD area 

— Address of interrupt trace hook* 

— Address of START I/O hook* 

— Address of transient dump hook* 

— Address of F/L trace hook 1 * 

— Address of F/L trace hook 2* 

— Reserved 

— Save area for registers 9, 10, and 1 1 



*A hook is coding introduced at supervisor generation. The coding normally branches around 
itself. The initialization makes the branch instruction a NOP to allow a PDAID function to be 
performed. 

Figure A.l . The PD address table (Displacements are in decimal) 

Byte 



16 



24 



32 
40 
48 



Phase Name 



VER 



MCD 



IGN2/TRC2 
CUU 



Alternate 



Area 



Log 
,CUU 



IGN3/TRC3 
CUU 



End 



PRT1 



PRT2 



PRT4 



PRT5 



Reserved 



Alternate Area Start 



1 

CHANC PTR 



1 

Reserved 



Reserved 



OPT 



1 

Register 10 



Displacement 


Label 


Description 


0-7 


Phase Name 


Phase being run 


8 


VER 


Version number in hex 


9 


MOD 


Modification level in hex 


10-11 


LOG 


Address of system log device 


1 2-1 3 


Output 


Address of output device 


14-15 
16-17 
18-19 


IGN1/TRC1 
IGN2/TRC2 
IGN3/TRC3 


Address(es) of devices to ignore or trace 


20-23 


Alternate 
Area Start 


Start address of alternate area 


24-27 


Alternate 
Area End 


Ending address of alternate area 


28-31 


CHANG PTR 


Address of channel queue pointer for output 
device 


32 
33 
34 
35 
36 


PTR1 
PTR 2 
PTR 3 
PTR4 
PTR 5 


Partitions to be ignored (see note) 


37-50 


Reserved 




51 


OPT 


Option byte X'00' = TRC device 
X'80'= IGN device 


52-55 


Register 10 


Save area for register 10 (used by GSVC trace only) 



Note: The initializer inverts the logic. When the user specifies a partition(s) to be traced, PDAID 
enters the partition (s) to be ignored in the standard preface table. 

Figure A.2. The PD Standard Preface Table (Displacements are in decimal) 
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PIK (Partition Identification Key) 

During debugging, it may be necessary to locate and to be able to interpret the PIK 
value allocated to each partition. 

The PIK of each partition is determined during system generation Jthe PIK value 
being contained in a two byte field at displacement address X'2E' in the appropriate 
partition communication region. Byte of this location always contains X'OO', 
and byte 1 a hex number equal to the displacement from the start of the PIB to 
the start of the entry in the PIB belonging to the partition. 



Appendix B 

PIK, SYSLOG ID 



Foreground partition PIK 

The PIK value for foreground partitions depends on how many partitions are 
specified by NPARTS parameter of SUPVR macro. 



PIK value at displacement address X'2E' of foreground COMREGs, 
where byte = X'OO' and byte 1 = ; 


NPARTS=5 


NPARTS=4 


NPARTS=3 


NPARTS=2 


PIK value indicated 


50 
40 
30 
20 


40 
30 
20 


30 
20 


20 


F1 
F2 
F3 
F4 



Note: The PIK values for foreground partitions do not change during system 
operation. 

Figure B.l. PIK Values 

Background partition PIK 

The PIK value for the BG partition is always X'10\ However, unlike the values in 
the foreground communication regions, the value held in this address changes during 
system operation. It always contains the PIK value of the active partition. 

Supervisor PIK 

A separate PIK value is given to the attention routine. The value is X'OO', and 
indicates that the supervisor is in control. 



SYSLOG ID 

For PD output, values will be AR, BG, F4, F3, F2, or Fl , which identify the 
partition generating the trace entry. 
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Appendix B 

TIK, LIK 



TIK (Task Interrupt Key) 

The halfword TIK at displacement X'5 A' in the SCP Communications Region 
(SYSCOM) has a zero value in the high-order byte and a key value in the low-order 
byte. This key value is only significant when AP is supported. The key value in 
the TIK is the key of the program (task or subtask) that is being serviced. When an 
interruption occurs* the value of the TIK indicates to the supervisor which program 
(task or subtask) was interrupted. 

The TIK is set by Task Selection in the General Exit Routine and equals the index 
displacement of the task's Program Information Block (PIB) within the PIB Table. 

Depending on the number of partitions supported, the value of the TIK indicates 
which task was interrupted according to the following table: 



TIK Value 


Interrupted 


NPARTS=2 


NPARTS=3 


NPARTS=4 


NPARTS=5 


Task 


X'OO' 
X'10' 

X'20' 

X'30'- 

X'FO' 


X'OO' 
X'10' 

X'20' 

X'30' 

X'40' - 

X'FO' 


X'OO' 
X'10' 

X'20' 
X'30' 
X'40' 
X'50' - 
X'FO' 


X'OO' 
X'10' 
X'20' 
X'30' 
X'40' 
X'50' 
X'60' - 
X'FO' 


Attention 
BG 
F4 
F3 
F2 
F1 

Subtasks* 



*Asynchronous Processing option. The number of PIBs initially available for subtasks is 10, 1 1, 
12, or 13, depending on the number of partitions (in an AP supervisor the total number of 
PIBs is always sixteen). 



LIK (Logical Transient Owner Identification Key) 

The halfword LIK at displacement 88 in the SCP Communications Region (SYSCOM) 
is only significant if AP is supported and contains the same value as the TIK when 
the logical Transient Area (LTA) is in use. LIK therefore, identifies the owner of 
the LTA. When the LTA is free, the halfword LIK contains zeros. The SVC 2 
routine sets the LIK, and the SVC 1 1 routine resets it to zero. If AP is not supported 
the LIK contains zeros. 
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LTK (Logical Transient Key) 

The halfword LTK at displacement X'6E' in each partition's communications region 
has a zero value in the high-order byte and a key value in the low-order byte. 

In a foreground communications region, the key value in the LTK is not significant. 
The LTK in the background communications region (BGCOMREG) has the same 
value as the PIK of the partition of the task that owns the LTA, or contains zeros 
when the LTA is free. When the LTA is occupied by a task, therefore, the 
BGCOMREG has the same value in its LTK as in its PIK when the owning task is 
active. The SVC 2 routine sets the LTK, and the SVC 1 1 routine resets it to zero. 
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LTK, REQIDTKREQID 



REQID (I/O Requestor's Partition or System Task ID) 

The REQID is one-byte identifier in the Channel Queue (CHANQ) entry. 

When a background or foreground program has requested I/O, the REQID has the 
same value as the key byte of the PIK for that task's partition. When the Attention 
Task has requested I/O, the REQID contains X'OO'. 

When the request for I/O is from a System Task, the REQID has one of the 
following values: 

RAS -X'OT 

PMGR - X'02' 

SUPVR -X'03' 

CRT - X'04' 

ERP -X'05' 

PAGEIN-XW 

The REQID is set by the Channel Scheduler Routine. 
Note that X'OO' indicates that no system task is active. 
TKREQID (I/O Requestor's Task Identification) 

The TKREQID is a one-byte identifier in the Channel Queue (CHANQ) entry for 
a task that has requested I/O (see Figure 4.1 3). In an unused CHANQ entry the 
TKREQID contains X'FF'. 

The TKREQID byte in an active CHANQ entry has the same value as the key byte 
of the TIK of the task that has requested I/O. 

If AP is not supported it has the same value as the PIK of the task that requested 
the I/O. 

TKREQID is set by the Channel Scheduler Routine and reset by the I/O 
Interrupt Handler. 
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Appendix C 

CONTROL REGISTER 
ALLOCATION 



Control 
Register 



10 



11 



12 



13 



14 



15 



SYSTEM CONTROL 


TRANSL. CONTROL 


EXTERNAL-INTERRUPTION MASKS 


SEGM-TBL LENGTH 


SEGMENT-TABLE-ORIGIN ADDRESS 




CHANNEL MASKS 














MONITOR MASKS 


PER EVENT MASKS 




PER GR ALTERATION MASKS 




PER STARTING ADDRESS 




PER ENDING ADDRESS 






ERROR-RECOVERY CONTROL & MASKS 






MCEL ADDRESS 



Figure C. 1 . 
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Appendix D 



The following two examples show the two different features of the ESERV program: 
that of de-editing without updating an edited macro definition, and that of de-editing 
and updating an edited macro definition. 

Sample Coding for De-editing without Updating a Macro Definition 



ESERV EXAMPLE 
JOBSTREAMS 



// JOB NOUPDATE 
//EXEC ESERV 
PUNCH E.MAC1,MAC2 

/* 
/& 



(See note 1 ) 
(See note 2) 
(See note 3) 



Notes: 

1. Name of job is NOUPDATE. 

2. Causes ESER V to de-edit the macro specified in the following PUNCH 
statement. 

3. Causes the macros MAC1 and MAC2 to be punched out from the macro 
library (E) 

You could use the above coding to produce a de-edited source macro for possible 
future updates. 

Sample Coding for De-editing and Updating a Macro Definition 

The Procedure in the following example produces a de-edited, updated macro 
definition in source format, and edits and places the update macro definition in 
the macro library, using the MAINT program. 



// JOB UPDATE 
// EXEC ESERV 

GENEND 



DSPCH E.MAC1 



) COL 77,4 
) VER 72+1,5 

.PP9 

) ADD 72+1 

AIF (&PCH NE 1400) D4 
) DEL 102,103 
) REP 245 

JOYCE CLC (4,REGG) ,BLANKS 
) END 
/* 

// PAUSE 

// OPTION EDECK,NODECK 
//EXEC ASSEMBLY 

(deck produced by ESERV 
goes here) 
/* 

// PAUSE 
// EXEC MAINT 

(deck produced by 
assembler goes here) 
/& 



Causes ESERV to de-edit the macro 
specified in the following DSPCH statement. 
Causes an END and /* statement to be 
generated. These are necessary to allow 
output from ESERV to be used immediately 
as input to assembler program. 
Causes the macro definition MAC 1 to be 
punched and printed from the macro 
library (E). 

For explanation see: "Verifying/ 
Updating Statements from a Printout 
of Macro Definition". 



Check list, move deck to reader. 
Causes the assembler to produce an edited 
deck (EDECK): no object module 
will be produced (NODECK). 



Move SYSPCH deck to reader. 
Causes MAINT to put edited macro 
definition on macro library. 
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Appendix E 

PROGRAM EVENT 
RECORDING 



The purpose of the program-event-recording facility is to assist in debugging 
programs, for example, SDAIDS. It permits the program to monitor the following 
events: 

• 



Successful execution of a branch instruction within the 
designated virtual storage limit 

Alteration of the contents of designated general registers 
Fetching of an instruction from designated storage locations 
Alteration of the contents of designated storage locations 



The information for controlling program-event-recording resides in control 
registers 9,10, and 1 1 , and consists of the following fields: 



Control register 9: 




EVENT M. 




GR ALTERATION M. 


8 16 31 
Control register 1 (X'A'): 




STARTING ADDRESS 


8 31 
Control register 1 1 (X'B'): 




ENDING ADDRESS 



8 31 

PER Event Mask: Bits 0-7 of control register 9 specify which events are monitored. 

The bits are assigned as follows: 

Bit 0: Successful Branching 

Bit 1: Instruction Fetching 

Bit 2: Storage Alteration 

Bit 3: General-Register Alteration 

Bit 4: Unassigned 

Bit 5: Unassigned 

Bit 6: Unassigned 

Bit 7: Unassigned 

Bits 0-3, when ones, specify that the corresponding events are monitored. When a 

bit is zero, the event is not monitored. 
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Appendix E 

The monitor call instruction provides the capability for passing control to a MO N I TO R CA L L 

monitoring program such as the IBM supplied SDAID trace routines, when selected 
indicators are reached in the monitored program. The indicators are MONITOR CALL 
instructions implanted in the monitored program. When executed, these instructions 
cause a program interruption for monitoring to take place, provided that an inter- 
ruption is allowed for the monitor class specified by the instruction. Along with the 
interruption, the monitor class number and a monitor code are stored for subsequent 
use by the monitoring program. 

The instruction MONITOR CALL designates one of 16 monitoring classes together 
with a set of 1 6 monitor masks in a control register. One mask bit is associated 
with each class. The execution of the instruction causes a program interruption 
when the monitor-mask bit for the class specified in the instruction is one. The 
cause of the interruption is identified by setting bit 9 of the interruption code to 
one, and by the information placed at locations 148-149 and 156-159 of low 
address storage. 

The monitor-mask bits are in bit positions 16-31 of control register 8. 





MONITOR MASKS 



16 31 



The mask bits, in ascending order of bit positions, correspond to monitor classes 
0-15. Any number of monitor-mask bits may be on at any time; together they 
specify the classes of monitor events that are monitored at that time. The mask 
bits are initialized to zero. 
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Appendix F 

LINE MODE TABLE 



This table is built at supervisor generation time when the TP=BTAM, or QTAM 
parameter is included in the SUPVR macro, and MODEL=l 15 or 125. An entry 
is built for each device for which the DVGEN macro includes the MODE=X'ssss' 
or X'ssssss' parameter. Each entry contains the actual mode setting for the device. 



Number 

of 

start /stop 

lines 



MODTAB 



— I — ' 



Number 

of 

BSC 

lines 



Maximum 



Maximum 



Actual < 



Actual <: 



The first 4 bytes of the table 

Maximum number of start/stop lines. Sej by the IOTAB 
macro at system generation 

Maximum number of BSC lines. Set by the IOTAB macro 
at system generation 

Actual number of start/stop lines. Determined by DVCGEN 
macros at system generation and ADD commands at IPL 



H Actual number of BSC lines. Determined by DVCGEN macro 
at 



system generation and ADD commands at IPL 



not used 



Line Mode settings for 
Models 115 and 125 Comm. Adapter 



Bytes 140-143 (X'8C'-X'8F') of the System Communication Region (SYSCOM) 
contain the address of the table. 

Label MODTAB identifies the first byte of the table 



Figure F. 1 . Line Mode Table (LMT) 
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Appendix G 



This appendix shows an example of the output obtained from a formatted stand- 
alone dump as generated by the IBM program DUMPGEN with the parameters 
FORMAT=YES and PPOOL=NO . 



EXAMPLE OF A 
STAND ALONE 
DUMP OUTPUT 



Refer to Section 2-A-3 for a description of DUMPGEN and the stand-alone dump 
program. 

In a system dump output, the supervisor area dumped is almost identical to that 
dumped by the formatted stand-alone dump, the only difference being that a 
system dump does not divide the dump into blocks of 2K storage areas. Refer 
to Section 2-A-2 for a description of the system dump. 

The programmer's remarks on the dump example indicate how the various tables 
and information blocks are located by using addresses stored in the communication 
regions. The programmer has also indicated the meaning of several bytes on the 
dump, enabling a mental picture to be built up of the system status just before 
the dump program was executed. 

Following the last but one 2K block of real storage (246 in the example shown), 
the page status information and contents of the control registers is printed. In 
the example shown of a formatted dump, the control registers are followed by the 
communication regions. (This does not include the system communication region.) 

The remaining part of the example shows the order and format of the tables and 
information blocks printed in a formatted dump output. 

The last block to be printed is the SELECTION POOL, the contents of which are 
explained in a note at the end of the example. 

IMPORTANT NOTE 

The location and addresses of the table and information blocks shown in this 
example apply only to the system that produced this example. The actual location 
of areas indicated depends on the system generation options specified, and the 
program running in your system just before the dump program is executed. 



GH 0-1 
GR 2-3 
GR 4-5 
GR 6-7 
GR 8-9 
GR A-B 
GR C-0 
GR E-F 



EXT OLD 
EXT NEW 
EXT INT 
SVC OLD 
SVC NEW 
SVC INT 
PGN OLD 
PGM NEW 
PGM INT 
MCK OLD 
MCK NEW 
MCK INT 
I/O OLD 
I/O NEW 
I/O INT 
CSH 
CAW 
TIMER 



00000000 
OO00E2BO 
00O00O0E 
O00OE330 
00079800 
0007B800 
00000E88 
0007 A935 

4B4B4B4B 
00080000 
00000000 
07400000 
04OCOO00 
00020007 
000C2000 
OOOCOOOO 
00040005 
00000000 
OOOCOOOO 
00000000 
070F2000 
00080000 
6000000C 
0007B038 
0007B030 
F4E3C400 



OO07B000 
9007B0D2 
00000000 
00000540 
0007A800 
0000E2A8 
00000029 
00000000 

4B4B4B4B 
OO00A67E 

00089B62 
00000BCC 

0000A648 
00079EC8 

00000000 
0007B078 
00000000 
0000090C 
O0O0A67E 

08000000 



a4 end «f eUAniJ. «f T&t/ 4&t<x**£. , 
bt/*t*. ■fctrvsttZlfc/ onfall ) 



SGirteC- a*C9~*Z oU**ry( 

Foam at ' Yes 
^XaU $Ut<o£ cut/cty 



KTiJ'^ fife, hJwacca/ CPO Mtttrt*') 



07BOOO 50B01O28 92021028 41F01028 50F00048 9C002000 47701010 90002000 47701018 

07B020 41BB0048 060107FE 0207AC88 20000048 0907B0D8 20000078 OOOAOOOO 00000000 

07B040 5C5C5C40 C5D60140 5C5C5CO0 928B1030 9D004O0O 47701050 9C004000 90004000 

07B060 4730105C 924010D8 027610D9 10089209 10309278 103707F3 92C10000 58100010 

07B080 48201182 48401184 41301030 50300048 92111030 45301050 D22610D8 11BE4530 



Figured part 1 of 20 



Appendixes. A.l 1 



Appendix G 

EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



mmmmmmmmmmm 






07B6C0 F24<K6E4 U5C3F3C9 36054005 06F340C5 E7C5C3E4 

07B6E0 1 >C9E3C9 C10340F2 t3Cl£3E4 E2C1C4C4 D9C5L2E2 

078700 O5E340E3 C1C203C5 40C9054!; C3D9F140 C105C440 

07B72P EJ4004C1 E3C3C8C3 J9F140C3 36051: JC5 l)5E 3E240 

07B74C 0306C3C1 E3C540E3 C 8C540E2 C5C 704C5 0SE341E3 

07B760 C306J5E3 C505E3E2 40C9E240 FJC1D2C5 0540E306 

07B780 E2C5C7D4 C5JSE340 E3CIC203 C5C2C5C7 D4CS05E3 
E34" 



3C5C40B 40C3D940 C90540C9 

Cbi:240C6 06094PE2 C5C704C5 

E2E'1F2C3 D60440C4 [)<>4C0506 

C9E240£3 C102C505 4PE30640 

C1C203C5 C901C2L2 C5C7F340 

400306C3 CIE3C540 E3C8C540 

40ESC1C2 D3C540C3 C1D50506 



^O767A0 .„. 

O7B7K0 E2( {'^ e * Jt - *W f **/ <* «<w^«Wl 0Juyn£t ?*«;*/ o&jJl "f - 
BLOCK o*>.; v ^ /f^*~v V_ _^ 



^ 



000000 
00002" 
000040 
000060 
000080 
OOOOAC. 
000C0 
0004AO 

iooo4cr 
. 0004EO 
"000500 
"" . 000520 
^000540 
000560 
000590 
0005AO 
0005C0 
0O05E0 
000600 
000620 



0006C0 
0006E0 
000700 
000740 
000760 
000780 
0007A0 
O007C0 
0007E0 



000800 
000820 
000840 
000860 
000880 
0008AO 
0008CO 
0008E0 
000900 
000920 



09004619 200000<>F 00010000 00O00JOO 00071)000 OP0OE2 Ab| 4B4B4B4h\ 4f(4B4B4B 

07400006 Qi > 0fr9B62 OOOCJOOO 6lOPA64$ 00^00000 "0000000 07OF2OP'" I000009OC 

F40C8900 020AFL5D (.00BP0CP POO0A67E 
OO0CO0O0 0007B3AA C0080P (■(. J0-IOOA67F 
_Wp^i)8^0_12P^lfO0_g^0jKrpiOJ^tiU^ 



1107)038 180( 0000 0007*0 30| 00000000 



noc-wo oooooncc 

rO0POO54OIO0OOuO0O 

^16166" 

0000000 , 

T)t>jf F JL__ 
■ 104^ 296 |4?97^ 3')9 
46 300000 30CC3C4C 
0100PQ10 04A010E0 



0POCOO0O 0000A5F0 
00"2C007 00040005 









660Q6 Ufl OnflWcA 

00017000 JO 2ft 05QE6 | 
60 8008O0'|»O00flt>SFC 
O000000"\o?<5o79; 
0000A5E2 
01081018 100200000 

0)000000 loooooono 

00006308 /OC0O0O0O 



Pub 

3FP03FC6 

3EBC101J OOOOO'yMflyflyr 

000058 1 C1C03. -5 



" 00000 IOC 60"0l0li0cl 0"O00O0O 



0032002C IQ005|TO00' 



5^66^66 1 HI)654E2 g404d740 

F07?CT0»-~taA 0C E DO 002E40FD 

.""-"" O00TJ3CC4J O0_"_1O13C 

Att&ttVl °f \- OO00 3R64 r t3BLl4feA30 

0/ » 2 1 40404040 4O404fi00 

:„l, j^.i^hVh uuL'UbHbi. i mijiiyAy 

ro^cl ooocoooo 00008299 00006OS8 

...... .;*.* y -- ^^- p 0£T£(_O4( 00074B0 

'/lctlfre*0 of CM* AM<^j OOi)04 24ft| 00000 760 

■**» 0/ fJeo*/A/£4 00003A8C ocoooooc 

>2 ')0"0000O 0''ij00000 



A(/c&ev> </ f</Bo*/ii/£4. 



7^ 



0001O043 0145.C0C0 



00000000 
01020008 
0083C083 
00830083 
0000*036 
00003EFO 
00000000 
06IJ006H0 
95030585 



41HB001F 
937E9463 
07FF960C 
41A008FC 
06B006BO 
30020787 
07F74880 
072F94FE 
9500060F 
U9109000 



00000000 
00C20406 
— SAMt — 
83838300 
00009260 
00100000 
000006BO 
06B006H0 
47700826 



07F6084C OOUduuuu 
080AOCOE 00183048 

00000000 0OO0C00O 
oocooooo 00000000 
00007118 00007100 
06B006B0 06B006BO 
06S006B0 06B006B0 
459008C2 47F00326 



00PQE640I]00P0DLB8| O00OF2Hf I0C00637B 
-"0145 



0000O00C [0141100031 I0000E640IJ0000DL88I 000 



naetHw) of 






JOO'J 



CPU. ID 



00O00O02 000OUUO3 

00007288 10007340 

06B04BB0 06E206BO 

06B006BO 06B041BB 001F41BB 0010181 

06B006BO 06B006BO 06B006B0 06B006BO 



Z"" 2K iJLU </ a£*x*4. . 



06B00680 
300642B0 
A00FAF01 
07FF06HO 
06B006BO 
18414340 
04CE8880 
058207F9 
47800A5A 
00140919 



41BB001B 
A00158B0 
01AE4400 
06B0O6B0 
06B0AFO5 
3002 8940 
00034 188 
4590C6C2 
A003099C 
06C 04780 



45700896 
065C960C 
B97A077F 
O6B0O6HO 
010050B0 
00055A40 
003B4188 
9283A000 
95000585 
09061BAA 



58900554 
A00FAF01 
9200050F 
06B006B0 
00008200 
05641 8AI 
06C0928 3 
58804004 
47701AA4 
50A0050C 



41F09244 
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02100910 
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09324890 
43A10015 









Lot/- cuuU&»> /t/trtvaa. 




M«*. £ytf 

°f ■fyu/' 



082641F0 
AF050021 
4560B814 
O6B006B0 
300495FF 
58104000 
06899283 
92000689 
04FADC10 
42A00585 



.R K.R.R. 



£k/o/ 



Figured part 2 of 20 



A. 12 Appendixes. 



Appendix G 

EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



Q0 \ AtUtM, <^1 
00. Bf ■^*mt*fy\ 
003BCO OOOOOOO ' 



CiJj 



/>/0Z &dyo~* 



£ tit 



003BE0 
003C00 
003C20 
003C40 
003CC0 
003CE0 
003000 
003020 
003040 
003D60 

fV 003DA0 
V nn-anrn 



00000000Xp4A0p00Q 00020007. 00000000 

00200000 44"foq"o"6~2" bbbooooo oooo'oboo" 

00400000 J 43B0O0BA 00000000 00000000 



60000004 0800E7E8 OOO00AO1 
C2C4E4D4 07401700 OO007OAO 
00000000 00000000 00000000 
.,J04AO0OO0 0007000B ooooooon 



00100000 .45900036 00020007 00000000 



00000000 — SAME — 

00000000 00000000 00000000 00000000 

000E2880 8200C2C7 80040000 00006458 

80441E80 8000C6F3 80007800 00006508 

009C1E80 8000C6F1 80008800 00006758 



O00OO0OOl 80O0 fclD9j OO0O0000 000063E8 



gV 



A 



00000000 80000000 00000000 000068D8 
00000 000 80000000 00000000 00006A58 
DOOOUUTO-aQOOOOOO 00000000 00006B08 
00000000 8000TXW0 00000000 00006058 
00000000 80000000 00000000 00006E08 



OOOE2880 8200C6F4 80061000 00006518 
00701E00 8300C6F2 80089000 00006698 
O0C81FOOI BO000OO0 00000000 00006818 



00000000 80000000 00000000 00006998 
00000000 80000000 00000000 00006B18 
00000000 80000000 00000000 OOO06C98 
00000000 80000000 00000000 00006E1B 

ooooooooi oooooooo oooooooo ooooooon 



03FO0- 
00 3F20 
003F40 
003F60 
003F80 
003FA0 
003FC0 
003FEO 



004000 
004020 
004040 
004060 
004080 
0040A0 
00 40 CO 



^ 



FFF* 
FFF* 
OOFF^! 
FFFFFF> 

FFFFFFFF FFFi Z. IWrfFFF 

OBFFFFFF 07FI OA/Ufnrx&n/l FFFFFFF 



z2» /V*n /detest/ ; 



rrrrrrrr rrrrrrrr nrrprrrrr 12ffoeff 

FFFFFF FFFF07FF 07FF07FF FFFFFFFF 



FFFFFFFF FFFFFFFF OOFFFFFF 
FFFFFFFF FFFFFFFF FFFFFFE 



FFFFFFFF FFFFFFFF 
FFFFFFFF FFFFFFFF 
07FFFFFF 07FF0708 
FFFFFFFF — SAME — 
FFFFFFFF FFFFFFFF 
FFFFFFFF — SAME — 
FFFFFFFF FFFFFFFF 



FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF 
10FF10FF 14FF15FF 00FFO7FF 06FF0606 
07090707 07FFFFFF FFFFFFFF FFFFFFFF 



FFFFFFFF FFFFFFFF 
OBFFFFFF 07FFFFFF 
FFFFFFFF FFFFFFFF 



FFFFFFFj^ /JU^tf FFFFFFF FFFFFFFF 



1BFFFFFF 07FFFFFF 07FFFFFF FFFFFFFF 



6201 2?e**C<l «/ 
6305 «J6*» 

oodf 



50C3 
50C3 



\ 004240 
7004260 
004280 
0042AO 
0042C0 
0042E0 
004300 
004320 
004340 
004360 
004380 
0043A0 
0043C0 
0043E0 
004400 
004420 
004440 
004460 
004480 
0044A0 
0044C0 
0044E0 
004500 
004520 
004540 
004560 
004580 
0045AO 
0045C0 
0045E0 
004600 
004620 
004640 
004660 
004680 
0046AO 
0046C0 
0046EO 
004700 
004720 
004740 
004760 
004780 
0047A0 
0047CO 
0047E0 



OOOOOOOO FFOOOOOO 
00 FFotjOO 



<?«W 6 c//w e^ fi iCo oa) ^FO0 

XOI FFOOOOOO 

66666666 fT6666oo oooooooo ffoooooo oooooooo 



013OFFO0 
'40F00000 

21o6o6f8 

620002F8 
620402F8 
50C300C0 
50C302C0 
OOOOOOOO 



6 20000F8 
OOD00508 
OOOEFFOO 
0131FF00 
O260FF0O 
02A2FFOO 
10381 FFOO 
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00000000 FFOTJOOOO 
00000002 00020008 
000000 OOOOOOOO 



00010001 
00000002 

oooooooo 



00010000 
00010008 

oooooooo 



00000008 
00080000 

oooooooo 



1428FF0B 
OOOOOBOO 
00001300 
00001B00 
00002300 
OOOO2B0O 
00003300 
00003BOO 

oofFoooo 



FF80FF49 
OOOOOCOO 
00001400 
00001C00 
00002400 
O0002C00 
00003400 

ooooffoo 
oooooqffI 



6628FF00 
OOOOOOOO 
00001500 
00001000 
00002500 
00002000 
00003500 
06FFOOOQ 



00000A67 
OOOOOEOO 
00001600 
00001E00 
00002600 
O0OO2EO0 
00003600 
OOOOOOFF 



C428FF15 
OOOOOFOO 
00001700 
OOOOIFOO 
00002700 
00002FOO 
00003700 
OOOOOOOO 



OOOOOOOO 
OOOBFFFF 
F2F0F6F7 
0000806C 
40404040 



OOOOOOOO 
FD7FCE03 
F3F3F4F0 
000073F8 
40404000 



050640D5 
000OCE50 
00003C04 
00003864 
40404040 



C104C540 
002E40FD 
0000003C 
3BD45A30 
40404000 



J F1F261F0 
OOOOOOOO 
41044296 
48100000 
OOOOOOOO 



9C28FF15 
00001000 
00001800 
00002000 
00002800 
00003000 
00003800 
OOFFOOOO 



9C2 8FF15 
00001100 
00001900 
00002100 
00002900 
00003100 
00003900 
OOOOOOFF 



OOOOOOOO 
OOOBFFFF 
F2F0F6F7 
00008075 
40404040 



OOOOOOOO 
F07FCED3 
F3F3F4F0 
00007340 
40404000 



C3C103C3 
30804E00 
00003CD4 
00003864 
40404040 



OOOOOOOO 
OOOBFFFF 
F2F0F6F7 
0000807E 
40404040 



OOOOOOOO 
FD7FCE03 
F3F3F4F0 
00007288 
40404000 



05664665 

0O00CE50 
00003C04 
00003864 
40404040 



E2C9D440 
002E40FD 
0000003C 
38D45A30 
40404000 



F1F261F6 
O00A1FFF 
41044296 
47980000 
OOOOOOOO 



F661F7F3 
OOOOOOOO 
42974389 
3DCC3E4C 
04A010E0 



OOOOOOOO 
OOOBFFFF 
F2F0F6F7 
00008087 
40404040 



OOOOOOOO 
FD7FCE03 
F3F3F4F0 
000071D0 
40404000 



OOOOOOOO 
OOOOOOOO 
00790000 
00000019 

oooooooo 

00510000 
00000013 

oooooooo 

00500000 
00000019 

oooooooo 

FFOOOOOO 
00000019 
OOOOOOOO 



oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 

03E80000 
OOOOOOFF 
OOOOOOOO 
03E80000 

oooooooo 
oooooooo 
oooooooo 
oooooooo 



62C5D5E2 
300OCE02 
00003CD4 
00003864 
40404040 



ClO4C540 
002E40FD 
0000003C 
3B045A30 
40404000 



J F1F261F0 
OOOOOOOO 
41044296 
47200000 
OOOOOOOO 



■fTCTFTFT - 

0008AFF6 
42974389 
3DCC3E4C 
04A010E0 



70007000 
OOOOOOOO 
3F003F06 
3EBC0010 
00000588 



9C28FF00 
00001200 
00001AOO 
00002200 
00002AOO 
00003200 
00003AOO 
OOOOOOOO 
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7666T666 

000804DF 
3F003F06 
3EBC0010 
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3F0C38F1 
00000050 
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D3D6D6D7 
002E40F0 
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3BD45A30 
40404000 



J F1F261F0 
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41044296 
46A80000 
OOOOOOOO 



F661F7F3 
OOOOOOOO 
42974389 
3DCC3E4C 
04A010EO 
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OOOOOOOO 
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FFOOOOOO 
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oooooooo 
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oooooooo 
oooooooo 

00790000 
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oooooooo 

00510000 
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F661F7F3 
00063C5B 
42974389 
30CC3E4C 
04A010EO 



66666666 

OOOOOOOO 
03E80000 
OOOOOOOO 

oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 

03E80000 



70007000 

oooooooo 

3F003F06 
3EBC0010 
00000588 



OOOOOOOO 
00000030 
3F0C38F1 
00000030 
COC00040 



2M66666 

00000019 
OOOOOOOO 
00500000 

oooooooo 
oooooooo 

00790000 
00000019 

oooooooo 

00510000 
00000013 

oooooooo 

00500000 
00000019 

oooooooo 



oooooooo 

00000020 
3F0C38F1 
00000020 
COC00040 



OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
03E80000 
OOOOOOFF 
OOOOOOOO 
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oooooooo 
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Appendix G 

EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



005D80 
0O5OA0 
0O5OCO 
OOSDEO 
005EOO 
0O5E20 
005E40 
005E60 
005E80 
OOSEAO 
00 5 ECO 
005EE0 
005F00 
005F20 
005F40 
005F60 
005F80 
005FA0 
005FC0 
005FEO 



0045*780 
96207003 
90001000 



0040E23C 



E4724B60 06E25060 00484166 0008D300 
92036000 47F0E386 D207E23C 00400203 
4720.E56C 4710E472 91020044 4710E472 



7798203A 
E680203A 
OOOOFFO 
OOOOFF 

oooof/oo 

OOOOfFOO 

OOOOFFOO 

OOOOKFOO 

OOOOF 

OOOOFFCfl 

OOOOFFOO 

OOOOFFOO 



M 



j ' i66 T ACagOSA 04F F fl88fl 



0000 OOOOFFOO FFFFOEOO OOOOFF 




7660»3A 
7730203A 
-U6&203A 



0048E215 
0048E230 
5060) 



96407000 47F0E386 



Q/U&t&eC £r 



K CC3 <**&**» - £?0X' 

FFFF3100 OOOOFFOO FFFFFFOO OOOOFFOO 



flooflooofl OgflOflflflfl ofloooooo 66000060 — 63066606 

00000000 00000000 05000000 00000000 00000000 
07000000 00000000 00000000 08000000 00000000 
00000000 OAOOOOOO 00000000 00000000 OBOOOOOO 



TJ4T1 

04FF0B00 

04FF0900 

FFFFOFOO 

: FF1300 

•-FF1700 

=FF1B00 

: FF1FOO 

hFFF2300 

FFFF2700 

"FF2B0O 

FFFH 0014 

75Soooooo 

06000000 
00000000 
00000000 



39A0033C 
7800203A 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 



61666666 
00000000 
00000000 

09000000 
00000000 



06FFFF0O 
04FF0C00 
FFFF1000 
FFFF1400 
FFFF1800 
FFFF1C00 
FFFF2000 
FFFF2400 
FFFF2800 
FFFF2C00 
FFFF3J220. 



00000000 
04000000 
00000000 
00000000 

ocoooooo 



.S£- L...S OT. 

-..OT.K.S. . K...S. ...£.... 
.11. r. 1 «.«. 

rHANQ & oi-*os^oo + o, 

-* OB -*OC - - - > yC-^r 



006000 
006020 
006040 
006060 
006080 
0060A0 
0060CO 
0060EO 
006140 
006160 
006300 
006320 
006340 
006360 
006380 
0063AO 
006 3C0 
0063E0 
006400 
006420 
006440 



00000000 00000000 00000000 00000000 

OFOOOOOO 00000000 00000000 10000000 

. iOOOOj 



( / •*/ 



00 OOOOFFOO 
1000000 FFOOOOOO 
IOOFFOO OOOOOOFF 
1000000 00000000 



.<=>&/-</ trmo, 



00000000 
00000000 
00000000 
007A0013 
00000000 



— SAME — 
00000000 
00000000 
00000000 
00000000 



1000E600 
00000000 
00200040 
00000000 



OAOOOOOO 
00000000 
00000000 
00000000 
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OO000E74 
000086BB 
00089000 

oooooooo 



6160F1H 

000084BA 
FFFF7D18 
— SAME — 
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00008534 
00008340 



0000C95C 
8000837A 
00008660 
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000082E8 00008318 00008308 00089040 
00004450 OOOOOOOO OOOOOOOO OOOOOOOO 
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0070A0 I OOOOOOOO OOOOOOOO QUU04104 oooooooo 
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009640 
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009680 
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98579120 47F091CC 41509120 5869 
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00003330 — SAME-- 

OCOOOOOO OOOOOOOO OOOOOOOO 0000 
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Appendix G 

EXAMPLE OF A 
STAND ALONE 
DUMP OUTPUT 



OODE40 
00DE60 
OODEBO 
OOOEAO 
OOOECO 
OOOEEO 
OODFOO 
OODF20 
00DF40 
0OOF60 
00DF80 
OODFAO 
OOOFCO 
OOOFEO 



OOEOOO 
OOE020 
00E040 
O0EO6O 
00E080 
OOEOAO 
OOEOCO 
OOEOEO 
OOE100 
OOE120 
00E140 
00E160 
00E180 
OOE1AO 
OOELCO 
OOE1EO 
OOE200 
OOE220 
00E24O 
OOE260 
OOE280 
00E2A0 
00E2C0 
00E320 
00E340 
00E360 
00E380 
0OE3A0 
00E3C0 
00E3E0 
OOE420 
O0E44O 
OOE4AO 
0OE4C0 
0OE4EO 
00E500 
00E520 
00E540 
00E560 
00E580 
OOE5AO 
OOE5CO 

I OOE640 
1 00E660 
0OE680 
0OE6A0 
00E6C0 
O0E6E0 
00E700 
O0E720 
00E740 
00E760 
O0E78O 
00E7A0 
00E7CO 
00E7E0 



FI3109200 F7485870 F6E407F7 9e /o ■ "rr 07E7aft»)0 OOOOOOOO OOQOOOOO O0O0O0OO 

oooooooo —same— /ape p*~dt,Jf __jt/°*<;£ t 

00000000 00000000 00020000 00>ju^.>| Qoo20ooomoouoooo: 00020000 00020000 

00020000 OC030000 00020000 00040000 - -r- -- r _ 

00020000 00070000 00020000 00080000 

00020000 OOOBOOOO 00020000 ooocoooo 

00020000 OOOFOOOO 00020000 00100000 

00020000 00130000 00020000 00140000 

00020000 00170000 00020000 00180000 

00020000 001BOOOO 00020000 OOICOOOO 

00020000 001F0000 00020000 00200000 

00020000 00230000 00020000 00240000 

00020000 00270000 00020000 00280000 

00020000 OO2BOO00 00020000 002COOOO 



.7...6U.7..6H 



fitfe fy/IMZ 7%BL€- 



002201F8 00820268 00220260 00830410 

000002A0 00810268 00000210 FFFF01E0 

000001C0 00C70418 000001A8 00C60188 

000001DO OOC40208 000001AO FFFF0170 

00000200 013901F0 00000228 013A01F8 

00000160 013102B0 00000248 01190298 

00000410 01130290 00000188 01170248 

00000298 01160230 00000270 013F0410 

00000280 01300270 00000288 01410278 

00000220 011A0258 00000190 00C80198 



00020000 00050000 00020000 00060000 

00020000 00090000 00020000 OOOAOOOO 

00020000 00000000 00020000 OOOEOOOO 

00020000 00110000 00020000 00120000 

00020000 00150000 00020000 00160000 

00020000 00190000 00020000 OOIAOOOO 

00020000 00100000 00020000 001E0000 

00020000 00210000 00020000 00220000 

00020000 00250000 00020000 00260000 

00020000 0029 0000 00020000 002AOOOO 

000200006020)0000; 000001EO FFFF 0400 

-^Lwt/u^JL U SUM <r 

00000208 00840240 I OOOOOIFO 6 I 3~B02A0~' 

00000250 00C501C0 0bo66iE"8 "0l'36"02i.8 

002202A0 00C20190 00000418 00C301D8 

00000268 01370180 000001F8 01380190 

00000108 00800188 000002B8 FFFF01A0 

00000290 01120200 00000258 01150250 

00000240 01180220 00000230 011401A8 

00000198 013501E8 00000278 013E0260 

000002A8 01400280 00000238 013C0228 

000002BO 01420288 00000218 014302A8 



000002CO FFFF0210 000002C8 FFFF02B8 

0OO0O2E0 FFFF02D0 0000O2E8 FFFF02O8 

00000300 FFFFC 

00000320 FFFFC 

00000340 FFFFC 

00000360 FFFFC 

00000380 FFFFC 

OOOOO3A0 FFFF0390 000003A8 FFFF0398 

000003C0 FFFF03B0 000003C8 FFFF03B8 



uo 



000002D0 FFFF02CO 000002D8 FFFF02C8 
000002FO FFFF02E0 000002F8 FFFF02E8 
00 00000318 FFFF0308 
00000338 FFFF0328 
00000358 FFFF0348 
00000378 FFFF0368 
80 00000398 FFFF0388 
000003B0 FFFF03A0 000003B8 FFFF03A8 
00000300 FFFF03C0 00000400 FFFF03C8 



30000000 00000000 00000000 OOOOOOOO 



100000 — SAME — 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 



00400048 00500058 00600068 00700078, 

00C000C8 00D00OO8 O0E00OE8 OOFOO 

01400148 01500158 016001681 801>d01 1 
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PBQE TAbLET i/fosi805i 
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00150015 00150015 J3t>150015 00150015 

02A10025 0025002X00250025 00250025 
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00250025 0035^035 00350035 00350035 



10000) 0008 00100018 00200028 00300038 



00800088 00900098 O0A000A8 0OB00OB8 
01000108 01100118 01200128 01300138 



&ME — 



/ <&ae /cu 



0035 
3045 
3045 
3261 



00350035 

00350035 

02490221 

0045004! 

01F101F/ 

005500/ 

005 50l)55<UU5au u!)5 UU55005S 00550055 

FOOtiiiJJJfOOOEjTfl F683E3B8 F566EJF6 

F000E530 F0OOE57O F000E5B0 F0O0E5FO 

0(30(30880 68882864 00OOE33O 0366151 8 

0000E830 OOOOOOOO OOOOOOOO OOOOOOOO 

OOOOOOOO 00O0E9O8 07023D1C 60000006 

06023D50 600000A0 92023038 20000005 

80000000 00089CE0 88000000 0000E998 



Z0900 /TSOO 17 800 /gooff itzeo^. 

rqjoiBi 1 018^ 0015 00150015 

T00150015 01C90101 01D901A9 01C101B9 

00250025 00250025 00250025 00250025 

00350035 00350035 00350035 00350035 

00350035 02290239 02510231 02590241 

oooooooy oooooooo oooooooo 



(X'/30' - 3/6- &*.) 






— s \ 









. j&&<j&>uy 



E43 0)foo6£476 |;666E4b6 ^66oWo I V SireMr T 



$' ■ _ /, _ fftto 
£7 _ - /7Voo 
^X - 



0666666I 68866601 0000000 

OOOOOOOO OOOOOOOO 0020C000 000614E8 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
3102301E 60000005 08O0E6D0 OOOOOOOO 



TABLE 



I? - 



— /%ooo 



OOOOOOOO — SAME- 

OOOOOOOO OOOOO OOO 80000000 0041770, 

oodoo666 .", 
oooooooo \iti*Z 

00008000 C«~»~v*W 
0000E6C8 
OOOOOOOO 0OOOE6C8 






V 



ccw copy BLOCK 



at/Ana 



Ju*U ti/~/*f -__^ ..HH.... 

9817fA41?BM6626 !69617FC4\Sobooo2F ; 



8LOCK 

00 E 800 
00E820 
00E840 
00E860 
00E880 
00E8A0 
00E8CO 
00E8E0 
0OE9O0 
OOE920 
OOE940 
00E960 
00E980 



CCS A<rt*t& ... 
29 C///9A/4 e~ty £ 



cw u SG«^« 



jo rooooE 



021 \ 
TToT" 



12«6000002 



09uiLVbt ^uuuuun, UUIJJ90U00 OOOOOOOO 
OOOOOOOO OOOOOOOO 8C)<500000 
OOOOOOOO — SAME— 
OOOOOOOO 00000000*0000000 
00008000 0C0O2OO3IOO00E758 
0000E758 OOOOOOOO VoOOOOOOO <t)0000000 



ft CCW 



copy &LOCK 



OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
" M """ n nnnnnnon i.= ™ C o-. » O0OO5A_ 

CCW COPY BLOCK ^ 300E8CO 



CC W ao6&e*!> i*t C$W 



0010C000 I 

oooopoooH 



ru| 



ooooooooy 
oooooooo 



■flotokev) off Vt*£i«tf OcS ^-/}c66e*> of '/ML t^vj. 



A CCB Co/>Y BLOCK 



TPAL B<jocK 



'(.£* 106 KT)\ 
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Appendix G 

EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



017800 

017820 

017840 

017860 

017880 

0178AO 

0178CO 

017960 

017980 

017A20 

017*40 

017A60 

017A80 

017AA0 

017AC0 

017AE0 

017B00 

017B2O 

01 

017E60 

017E8O 

017EA0 

017EE0 

017F00 

017F20 

017F40 

017F60 

017F80 

017FA0 

017FC0 

017FE0 



4040D440 40404040 C1D4E240 40404040 

D5C4CS09 40C2C5D3 CID5C709 C 90 1024B 

C5D3C905 C740E5C1 0S40E2C9 E3E4C1E3 

E340 

E4E2 

C9C5 

4040 

4040 

4040 

4040 

C6C7 

0703 

4040 

D6C7 

40E5 

4040 

C9D5 

4040 



40404040 

40E5C509 

C9C 54004 

J40 

>D6 

)40 



40404040 
C4C509C5 
D6C5E340 
05C9C5E3 
09C4E340 
40404040 



Pub oo ob***, <mww> ooof 

o&4<<*> ffit, 00 - PR- KB , v*4 )*o 

Duty, a*u/ pu&buec 4r Cflrf/yQ , 09 

nJty 0*f- . »° 

A<&/Uv> y ' cc& co/>y at-o^H £° 
(£**. ccb **64«v> u c#/)/rtf)*£?osUo 

7840 oooo A Joke* *ft / CCd/ Co/>Y Alock 

'" (/*»» Oc'B coW Acock)* £7£% Joo 

/\d</nv> >f //O as<^(j4*>~y / sr )F6 

/ )00 



4040C340 
4006D5E3 
C1C6C7C5 
40E5C5D9 
C7C5C505 
40404040 



7E4004C9 
E6C90202 
E6C1C3C8 
06D5E309 
40C1D2E3 
40404040 



;40 40404040 40404040 40404040 



E5D606D9 
D5E3C9C5 
C7C505E3 
40404040 
03D3C9D1 
40404040 
09C90102 
40404040 
40404040 



0306D7C9 
40400703 
C9C5C3D6 
4040C140 
D2C540C 1 
40404040 
4B40C102 
40404040 
40000000 



C75040C1 
E3407E40 
C4C57A40 
7E40C806 
02E3C9C5 
40404040 
E3C9C540 
40404040 
00000000 



0000005C 00000000 OOOOOOOC 
0000012C 8004033C 00000000 



0000 
0000 
0000 
0000 
4040 
1780 
0904 

0904. _ ._- 

0A0418B9 20000000 I2fc4t/ 40 C7C505C5 09C1E306 09400906 E4E3C9D5 CS40C1C3 



be tf )~ '/yrtrff 
$&*£ eft z/o a^eoc 



404040F1 
04000000 
00000000 
6000001 F 
60000020 



404040F5 
00040004 
09041788 
09041812 
09041894 



404040FO 
17380004 
600000 1C 
60000021 
20000025 



E3C9SSC5l4 0404040')E2C503C5 C3E340C1 40C2E4C7 
40D6D5C5140404040/D6C640E3 C8C540C6 06030306 
40C60603|0306E6C5/C440C2EB 40C506C2 4B404040 



40C2E840 
E6C905C7 
40404003 



C505E3C5 
4003C5E3 
404040C5 



D9C905C7 
E3C5D9E2 
D5E3C5D9 



BLOCK 048 



/' r l&U<ySc6t& ^/fr 



/* / Sr CCH/' 



n ANS C . HI 

NOER BELANGRIJK. VEROERE ONTUIKK 

EL1NG VAN SITUAT IE HOET AFGEMACH 

T HORDEN . .N OG. NIET VERONTR 

USTEND. VOORLOPI G WOROT GEEN AKT 
IE ON0ERN0NEN 



•• AFKORTINGEN 

FGEMERKT UGN . 
PLAA7S 



»* 



• .VOORLOPIG. A 
URGENT IE PLT . 
URGENT I ECOOE. 
A . HO 
OGST URGENT. ONH IDDELLIJKE AKTIE 
VEREIST 

B . BE LANGRIJK. AKTIE 
IN NABIJE TOEKON ST 



...TOMS 12 
33ANSTER0A 



018000 40C10540 E405C5D5 C4C905C7 40030606 D7504040 4040C940 40400709 06C4E4C3 



? ..... f M )G GENE RAToR ROUTINE AC 

ftvEl SELECT A BUG BY ENTERING 

ONE OF THE F OLLOHING LETTERS 

FOLLOWED BY EOB . L .ENTER 



AN UNENDING LOO P. 



03FDC0 
03FOE0 
O3FEO0 
03FE20 
03FE40 
03FE60 
03FE80 
03FEA0 
03FEC0 
03FEE0 
03FF00 
03FF20 
03FF40 
03FF60 
03FF80 
03FFA0 
03FFC0 
03FFEO 



C6F20740 
00089D24 
00089A7C 
00089B58 
07402000 
9024C6F2 
9A7C0708 
9B620008 
00000008 
C6F2074D 
00089024 
00089A7C 
00089B58 
07402000 
9D24C6F2 
9A7C0708 
9B620008 
00000000 



00000008 
C6F20740 
00089024 
00089A7C 
00089B58 
074D2000 
9D24C6F2 
9A7C0708 
98620008 
00000008 
C6F2074D 
00089024 
00089A7C 
00089B58 
07402000 
9D24C6F2 
9A7C0708 
00000000 



9B620008 
00000008 
C6F2074D 
00089024 
00089A7C 
00089658 
07402000 
9D24C6F2 
9A7C0708 
9B6200O8 
00000008 
C6F20740 
00089024 
00089A7C 
00089B58 
07402000 
9024C6F2 
00000000 



9A7C0708 
96620008 
00000008 
C6F20740 
00089024 
00089A7C 
00069B58 
07402000 
9024C6F2 
9A7C0708 
9B620008 
00000008 
C6F20740 
00089D24 
O0089A7C 
00089858 
07402000 
00000000 



9024C6F2 07402000 00089B58 00089A7C 
9A7C0708 9D24C6F2 07402000 00089B58 

/^ Z&. MM fSl/C tnUfi. 

uuuavu*:* i»or-«;u/4u uuuouuob vooiuuua 
00089A7C 00089024 C6F20740 00000008 
00089858 0O089A7C 00089024 C6F20000 

oooooooo oooooooo ooooopoo oooooogoL^ 



•W 



• Wy 






040000 OOOOOOOO OOOOOOOO 00001 

040020 — SAME— 

0407E0 OOOOOOOO OOOOOOOO OOOOt 



BLOCK 129 






00 OOOOOOOO 

oo oooooooo 



00 oooooooo 



040800 oooooooo OOOOOOOO OOOOt 
040820 — SAME — 

040FE0 OOOOOOOO oooooooo oooooooo oooooooo OOOOOOOO oooooooo oooooooo oooooooo 






(TbcPU 



a/e<ri 



oooooooo oooooooo oooooooo oooooooo 

— SAME — 



oooooooo oooooooo oooooooo oooooooo 
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Appendix G 

EXAMPLE OF A 
STAND ALONE 
DUMP OUTPUT 



\ 



079FE0 OOOOOOOO 00000000 00000000 00000000 00000000 00000000 00000000 00000000 

BLOCK 244 

07A000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 

07A020 — SAME — 

07A7E0 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 

BL0CK 2 „ ^ l<*/ ZH tJ&U A<f <r*t* 0^ OPO jfJyAAC*/ (->™>u»i) si^Z+p*' 

07A800 00000000 00000000 00000000 OOOOOOOO 00000000 00000000 00000000 00000000 ................ ..... 

07A820 — SAME— 

07AFE0 OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO ..... 

END OF CORE DUMP 



(ex i<#* 























IJBSEGT CONTENTS IS TAKEN TC 


LOCATE THE SEGMENT TABLE 








VIRT.AODR 


REAL AODR 


BLOCK 


STATUS 










t 000000 


000000 


000 


CHANGEO *\ 
CHANGED 










000800 


000800 


001 










001000 


001000 


002 


CHANGEO 










001800 


001800 


003 


UNCHANGED 










002000 


002000 


004 


CHANGED 










002800 


002800 


005 


CHANGED 










003000 


003000 


006 


UNCHANGED 










003800 


003800 


007 


CHANGED 










004000 


004000 


008 


CHANGED 










004800 


004800 


009 


CHANGED 










005000 


005000 


010 


CHANGED 










005800 


005800 


Oil 


CHANGED 










006000 


006000 


012 


CHANGED 










006800 


006800 


013 


UNCHANGED 










I 007000 


00700r 


014 


CHANGED 


l /- y /f/f rf ~? — 






*C.<M 1 ' 


jJi 007800 
*^ 008000 


007800 
008000 


015 
016 


CHANGED 
CHANGEO 


(^*i- <22T /tt^jBtwCJW •) 






*"t 


) 008800 
009000 
009800 


008800 
009000 
009800 


017 
018 
019 


CHANGED 
CHANGED 
UNCHANGED 








OOAOOO 


OOAOOO 


020 


CHANGED 










00A800 


00A800 


021 


CHANGED 










OOBOOO 


OOBOOO 


022 


CHANGED 










00B8O0 


OOB800 


023 


CHANGED 










OOCOOO 


OOCOOO 


024 


CHANGED 










00C800 


00C800 


025 


CHANGED 










OODOOO 


OODOOO 


026 


CHANGED 










000800 


00D800 


027 


CHANGED 










OOEOOO 


OOEOOO 


028 


CHANGED 










00E800 


00E800 


029 


CHANGED 


1 








OOFOOO 


OOFOOO 


030 


CHANGED / 








• . ■ 1 


O0F8O0 


00F800 
010000 


031 
032 


CHANGED / 
CHANGEO "\ 








010000 






010800 


010800 


033 


CHANGED 










011000 


011000 


034 


CHANGED 










011800 


011800 


035 


CHANGED 










012000 


012000 


036 


CHANGEO 










012800 


012800 


037 


CHANGED 


/ ' rf / J S — ' s 








013000 
013800 


013000 
013800 


038 
039 


CHANGED ' 
CHANGED 


) 5 e^nui*/' 1 , o^tu /r M?" °" &** ^6*1*?*' from 








014000 
014800 


014000 
014800 


040 
041 


CHANGED 1 
CHANGED 








015000 


015000 


042 


CHANGED | 








015800 
016000 
016800 


015800 
016000 
016800 


043 
044 
045 


CHANGED 
CHANGED i 
CHANGED / 


)//o Jia*ju> fi**n Se**&*X 2 £>>/ 3 "V^^/ 




1 








03D800 
03E000 
03E800 


03D800 
03E00O 
03E800 


123 
124 
125 


CHANGED "" 
CHANGED 
CHANGED / 








O3F0O0 


03F000 


126 


CHANGED 1 


' ' ' ' *> «* c^u^t *se«.. 








03F800 


03F800 


127 


CHANGED I 








040000 


020800 


065 


CHANGED ~] 


"Sty****/ '' $ 5 A**& ■£«***> wuu/^ #9 ^ r«~~c^, 

6* ire*4eiuiZ ln*V&— . 






• i 
• 


040800 
041000 
041800 
042000 


019800 
017800 
018000 
018800 


051 
047 
048 
049 


CHANGED ( 
CHANGED r 
CHANGED ) 
CHANGED J 






061000 


01C800 


057 


CHANGED 


. ^ (fie //OH?, 








061800 


01D000 


058 


CHANGED 
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/ 



Appendix G 

EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 













• 


09E800 027800 079 UNCHANGED^^^™^T^^^T^^™""T^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 
09F000 027000 078 UNCHANGED |- /art <>f ? **"****</ / 
09F800 026000 076 UNCHANGED 1 * 






• 
• 
• 


0A0000 028800 081 CHANGED ~) , 
0AO800 028000 080 CHANGED / <tcMKJi~S /O 
0A1000 02A800 085 UNCHANGED \ J ^f nawv 






• 


STORE STATUS FUNCTION NOT EXECUTED, CR IN INITIAL STATUS <* — 






• 


CR 0-7 000000E0 00000000 FFFFFFFF FFFFFFFF 00000000 00000000 00000000 OOOOOOOO 
CR 8-F OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO C2000000 00000200 







































*** 


COMMUNICATION 


REGION *** 












m HEX 


BG 


F4 


F3 


F2 


Fl 










• DISP 


04A0 


4590 


44F0 


4450 


43B0 


COMMUNICATION REGION ADDRESS 








00 


12/06/73 


12/06/73 


12/06/73 


12/06/73 


12/06/73 


DATE 








_ 08 


7000 


7000 


7000 


7000 


7000 


PPBEG ADDR 








• OA 


7000 


7000 


7000 


7000 


7000 


END OF STORAGE PROTECT 








OC 


0000 


0000 


0000 


0000 


0000 


SEEK ADDRESS SLOCK, ONLY BG VLD 








_ OE 


0000000000 


0000000000 


0000000000 


0000000000 


0000000000 


PROBLEM PROGRAM USERS 










OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


AREA IN HEX 








17 


00 


00 


00 


00 


00 


UPSI BYTE IN HEX 








A l8 


TOMSDMP 


KENSLOOP 


NO NAME 


CALCSIM 


NO NAME 


JOB NAME 








• 20 


00060FFF 


00074FFF 


OOOOOOOO 


000A1FFF 


OOOOOOOO 


UPPERMOST BYTE OF EACH PPA 








24 


0004232F 


00063C5B 


OOOOOOOO 


0008AFF6 


OOOOOOOO 


END AODR OF LAST FETCH OR LOAD 








A 28 


0004232F 


OOOOOOOO 


OOOOOOOO 


0008D4DF 


OOOOOOOO 


LARGEST PROBLEM PROGRAM PHASE 








• 2C 


0000 


0000 


0000 


0000 


0000 


LENGTH OF PP LABEL AREA 








2E 


0040 


0020 


0030 


0040 


0050 


PROGRAM IDENTIFICATION KEY 








A 30 


OOOBFFFF 


OOOBFFFF 


OOOBFFFF 


OOOBFFFF 


OOOBFFFF 


END OF STORAGE ADDRESS 








• 34 


FO 


FD 


FO 


FD 


FO 


MACHINE CONFIGURATION 








35 


7F 


7F 


7F 


7F 


7F 


SYSTEM CONFIGURATION 








3 36 


CE0330A0CEO0 


CED33000CED2 


CED30000CE50 


CED330804ED0 


CED30000CE50 


JOB CONTROL SWITCHES 








3* 3C 


002E 


002E 


002E 


002 E 


002E 


DISK ADDR OF LABEL CYLINDER 








3E 


40F0 


40FD 


40FD 


40FO 


40F0 


ADDR OF FOCL 








_ iO 


4104 


4104 


4104 


4104 


4104 


AOOR OF PUB 










4296 


4296 


4296 


4296 


4296 


ADDR OF FAVP 








44 


4297 


4297 


4297 


4297 


4297 


ADOR OF JIB 








_ 46 


4389 


43 89 


4389 


4389 


4389 


AODR OF TEB 








• 48 


3F00 


3FO0 


3F00 


3F00 


3F00 


ADOR OF FICL 








4A 


3F06 


3F06 


3F06 


3F06 


3F06 


AODR OF NICL 








_ 4C 


3F0C 


3F0C 


3F0C 


3F0C 


3F0C 


ADDR OF LUB 








• 4E 


38 


38 


38 


38 


38 


LINE COUNT FOR SYSLST 








4F 


120673340 


120673340 


120673340 


120673340 


120673340 


SYSTEM DATE 








— 58 


0000 


0000 


0000 


0000 


0000 


LIOCS COM BYTE 








• 5A 


3C04 


3C04 


3C04 


3CD4 


3CD4 


ADDR OF PIB TABLE 








5C 


0000 


0000 


0000 


0000 


0000 


LAST CHECK POINT NO. 








A 5E 


003C 


003C 


003C 


003C 


003C 


JOB ZONE IN MINUTES 








• 60 


4630 


46A8 


4720 


4798 


4810 


ADDR OF DIB 








62 


0000 


0000 


0000 


0000 


0000 


CURRENTLY NOT ASSIGNEO 








_ 64 


3DCC 


3DCC 


3DCC 


30CC 


3DCC 


ADDR OF PC OPTION TABLE 








• 66 


3E4C 


3E4C 


3E4C 


3E4C 


3E4C 


ADOR OF IT OPTION TABLE 








68 


3EBC 


3EBC 


3EBC 


3EBC 


3EBC 


ADDR OF OC OPTION TABLE 








_ 6A 


0010 


0010 


0010 


0010 


0010 


KEY OF PROGRAM WITH IT SUPPORT 








• 6C 


0000 


0000 


0000 


0000 


0000 


CURRENTLY NOT ASSIGNEO 








6E 


0000 


0020 


0030 


0040 


0050 


LTK 








_ 70 


00008090 


00008087 


0000807E 


00008075 


0000806C 


SYSPARN 








• 74 


00007118 


000071D0 


00007288 


00007340 


000073F8 


JOB ACCOUNTING 








78 


00003864 


00003864 


00003864 


00003864 


00003864 


ADDR OF TOO COMMUNICATIONS AREA 








_ 7C 


3BD4 


3BD4 


3B04 


3BD4 


3 804 


AOOR OF PIB EXTENSION 








• 7E 


5A30 


5A30 


5A30 


5A30 


5A30 


ADOR OF MICR DTF LABEL 








BO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


ADDR OF QTAM VECTOR TABLE 








_ 84 


04 AO 


04AO 


04 A 


04A0 


04 AO 


AOOR OF BG COMREG 








• 86 


10E0 


10E0 


10EO 


10E0 


10E0 


RESERVED 








88 


00000588 


00000588 


00000588 


00000588 


00000588 


AODR OF COMREG EXTENSION 








- 8C 


COCO 


COCO 


COCO 


COCO 


COCO 


RESERVED 








• 8E 


03 


00 


00 


00 


00 


DISK CONFIGURATION BYTE 


fex/nxt) 
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EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



\ 
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Appendix G 

EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



































*•* 


PHYSICAL UNIT BLOCK TABLE »** 












• POS 


CHAN 


CHAN 


TEB 


DEV DEV 


CHAN JOB DEV SUIT EOF IOERR OPER OEV BURST SEVEN 


* PUB OMNER * 










AND 


QUE 


PTR 


TVP CODE 


SCHO CTL BUSY CHAB SYSRDR QUED INTV END DV ON TRACK 


•• SHIP •* 










UNIT 


PTR 






FLGS FLGS LE SYSIPT RECOV REO POST NPX TAPE 


* EXTENSION * 








000 


0009 


04 


00 


00 00 


80 F8 * 




0000 








_ 001 


OOOC 


FF 


00 


11 00 


00 F8 




0001 








• 002 


OOOO 


FF 


00 


21 00 


00 F8 




0001 








003 


OOOE 


FF 


00 


42 00 


00 F8 




0001 








_ 004 


ooir 


FF 


00 


00 00 


00 F8 




0000 








• 005 


0111 


FF 


00 


BO FO 


00 F8 




0000 








006 


0130 


FF 


00 


62 00 


02 F8 




OOOB 








- 007 


0131 


FF 


00 


62 01 


02 F8 




001F 








• 008 


0132 


FF 


00 


62 02 


02 F8 




0000 








009 


0133 


FF 


00 


62 03 


02 F8 




0000 








— 00» 


0134 


FF 


00 


62 04 


02 F8 




0000 








• ooa 


0260 


FF 


00 


63 OS 


02 F8 




001F 








00C 


0261 


FF 


00 


63 06 


02 F8 




0000 








^ 000 


02 AO 


FF 


00 


50 C3 


00 CO 




0000 








• ooe 


02A1 


FF 


00 


50 C3 


00 CO 




0002 








OOF 


02A2 


FF 


00 


50 C3 


00 CO 




0002 








^ 010 


02A3 


FF 


00 


50 C3 


00 CO 




0008 








• Oil 


02A4 


FF 


00 


50 C3 


00 CO 




0000 








012 


0380 


FF 


00 


50 C3 


02 CO 


* 


0002 








m , 013 


0381 


FF 


00 


50 C3 


02 CO 


• 


0001 








• 014 


0382 


FF 


00 


50 C3 


02 CO 


• 


0008 








01S 


0383 


FF 


00 


50 C3 


02 CO 


* 


0008 


/&//f4T 
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*** COPIED AND TRANSLATED CC8 *** 






• 00E908 






AOOR.OF CCB COPY BLOCK QUEUE 






0000 






RESIDUAL COUNT 






A ° 4 






1ST COMMUNICATION BYTE 






• 00 






2ND COMMUNICATION BYTE 






0000 






STATUS BYTES FROM CSW 






A 20 






LUB CLASS 






• 0* 






LUB NUMBER 






0O0OE7E8 






AOOR.OF CCW STRING 






~ 00 






3RD COMMUNICATION BYTE 






• 041780 






CCM ADDRESS IN CSW 






0000000000000000 






USER SENSE CCW 






_ 0010 






PIK VALUE 






• CO 






FLAG BYTE 






00 






UNUSED 






_ 00041712 






AOOR.OF VIRTUAL CCB 






• 0000E7E8 






ADDR.OF CCW COPY. BLOCK 






OOOOE9S0 






ADDR.OF IDAL 






3 _ 000000000001800000000000000000000000000000000000 


PAGES FIXED 






om oooooooo 






PTR TO FIXINF EXT 






00000000 






ADDR.OF NEXT CCB 




(exrt/ xr) 1 


i •** 


COPIEO AND 


TRANSLATED CHANNEL PROGRAM *** 






w | AOOR.OF CCW BLOCK 


CON. CODE 


DATA ADOR. FLAGS BYTE COUNT VIRT.AODR.OF 1ST CCU 


AOOR.OF NEXT CCM BLOCK 




i 

m 00E7E8 CCH1 


09 


017F88 


60 001C 041738 


00E710 




• CCW2 


09 


017FA4 


60 0020 






i CCU 3 


09 


017FC4 


60 002F 






m CCM4 


09 


OOE950 


64 001F 






• CCH5 


09 


018012 


60 0021 






1 CCH6 


09 


018033 


60 0021 






m 1 CCM7 


09 


018054 


60 0020 






• 1 ■ ■ TIC 


88 


O0E710 








1 TIC 


88 


000000 








• i 00E710 CCM1 


09 


018074 


60 0020 041770 


000000 




1 CCH2 


09 


018094 


20 0025 






_ CCM3 


00 


000000 


00 0000 






• CCH* 


00 


000000 


00 0000 






! CCW5 


00 


000000 


00 0000 






— ' CCH6 


00 


000000 


00 0000 






• CCH7 


00 


000000 


00 0000 






I TIC 


80 


000000 








_ i TIC 


88 


000000 



















^few*jrt 






*** 


IDAL BLOCK QUEUE *** 






• AOOR.OF IOAL BLOCK 


IDAL ADDRESSES 








_ 00E950 00017FF3 00018000 FFOOOOOO 












*** 


FIXED PAGE FRAMES *** 






-. 0000047 0000048 
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*** BOUNDARY BOX ♦** 



ADOR.OF ALTERNATE AREA 

N.OF PAGE FRAMES IN NIN.REAL PART 

N.OF PAGE FRAMES IN MAIN PAGE POOL, 

ORIGIN OF VIRTUAL STORAGE 

ENO OF VIRTUAL STORAGE +1 



ORIGIN OF REAL PARTITION 
END OF REAL PARTITION ♦ ! 
ORIGIN OF VIRTUAL PARTITION 
END OF VIRTUAL PARTITION ♦! 



,017000 01E800 021000 023800 027000 

01E800 021000 023800 027000 02A800 

040000-> 061000 075000 089000 0A2000 

061000 I 075000 089000 OA2000 OCOOOO 




F2 



Fl 








liFFF 


SoP 


noov 

l£7FF 


B<? 


loTFF 


F4 




f3 


IJVoo 


Fl 


t*7FF 


F1 


Pof 


P~4 


lD9oo 
IFFFfi 


Hfl /V 

PP/I/D 




Art* OK 

SK5I//S 
CPOS) 

} SV/I (**/**£/ 
in 6£) 






1 
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*** SEGMENT TABLE *** *** 


PAGE TABLE 


»«* 










• ADOR.OF ST PT ENTRIES PT ORIGIN AODR 
00E640 32 00E33O 


VIRT.ADDR 


REAL AODR 
000000 


KEY 
00 


STATUS 
CHANGED 






; 


I 000000 






000800 


000800 


00 


CHANGED 










001000 


001000 


00 


CHANGED 










001800 


001800 


00 


UNCHANGED 










002000 


002000 


00 


CHANGED 










002800 


002800 


00 


CHANGEO 










003000 


003000 


00 


UNCHANGEO 










003800 


003800 


00 


CHANGED 










004000 


004000 


00 


CHANGED 










004800 


004800 


00 


CHANGEO 










005000 


005000 


00 


CHANGED 










005800 


005800 


00 


CHANGED 










006000 


006000 


00 


CHANGED 










006800 


006800 


00 


UNCHANGEO 










007000 


007000 


00 


CHANGED 








Sejtn&tt/' O 


007800 


007800 


00 


CHANGED 








008000 


008000 


00 


CHANGEO 








' 


008800 


008800 


00 


CHANGED 










009000 


009000 


00 


CHANGEO 










009800 


009800 


00 


UNCHANGED 










OOAOOO 


OOAOOO 


00 


CHANGED 










00A800 


0OA8O0 


00 


CHANGED 










OCBOOO 


OOBOOO 


00 


CHANGED 










OOB800 


00B800 


00 


CHANGEO 










OOCOOO 


OOCOOO 


00 


CHANGEO 










00C80O 


00C800 


00 


CHANGED 










OODOOO 


OODOOO 


00 


CHANGED 










00D800 


00D8O0 


00 


CHANGED 










OOEOOO 


OOEOOO 


00 


CHANGED 










0OE8O0 


OOE800 


00 


CHANGEO 










OOFOOO 


OOFOOO 


00 


CHANGED 










00F800 


0OF8O0 


00 


CHANGED 








# So 


/>W 














*** SEGMENT TABLE *** 


*«» 


PAGE TABLE 


*»» 










• ADDR.OF ST PT ENTRIES PT ORIGIN ADDR 


VIRT.AODR 


REAL AOOR 


KEY 


STATUS 








OOE644 32 00E370 


010000 


010000 


00 


CHANGED 










010800 


010800 


00 


CHANGEO 










onooo 


onooo 


00 


CHANGEO 










011800 


011800 


00 


CHANGED 










012000 


012000 


00 


CHANGED 










012800 


012800 


00 


CHANGEO 










013000 


013000 


00 


CHANGEO 










013800 


013800 


00 


CHANGED 










014000 


014000 


00 


CHANGED - 

CHANGED, "' rf *<*■ 

CHAttfftf) 1 










014800 


014800 


00 


/3<? 








015000 


015000 


00 








w 


015800 


015800 


00 


^CHANGED 








S^tyn^yivT 1 , 


016000 


016000 


00 . 


S CHANGEO 








1 016800 


016300 


ao; 


CHANGEO 

NOT ADDRESSABLE 






# / v 


k 017000 






017800 






NOT ADDRESSABLE 










018000 




10 


NOT ADDRESSABLE 










018800 




10 


NOT ADDRESSABLE 










019000 




10 


NOT ADDRESSABLE 










019800 




10 


NOT ADDRESSABLE 










OlAOOO 




10 


NOT ADDRESSABLE 










01A800 




10 


NOT ADDRESSABLE 








3 O1BOO0 




10 


NOT ADDRESSABLE 








□ • Or 01B800 

* ? 7 oicooo 




10 


NOT ADDRESSABLE 










10 


NOT ADDRESSABLE 










01C800 




10 


NOT ADDRESSABLE 










010000 




10 


NOT ADDRESSABLE 










01D800 




10 


NOT ADDRESSABLE 










01E000 




10 


NOT ADDRESSABLE 










01E800 




20 


NOT ADDRESSABLE 








' 


' 01F000 




20 


NOT ADDRESSABLE 








^ ■, , 01F800 




20 


NOT ADDRESSABLE 


(&C/ZS4 
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033000 


00 NOT ADDRESSABLE 












033800 


00 NOT ADDRESSABLE 












.03*000 


00 NOT ADDRESSABLE 












034800 


00 NOT ADDRESSABLE 












035000 


00 NOT ADDRESSABLE 












035800 


00 NOT ADDRESSABLE 








/ 




036000 


00 NOT ADDRESSABLE 








oejmz#A 3 


50/>M 


036800 


00 NOT ADDRESSABLE l/r /? 










037000 


00 NOT ADDRESSABLE 








/ 


A 




037800 

038000 

038800 

039000 

039800 

03A000 

03A800 

03B000 

03B800 

03C0O0 

03C800 

O3D00O 

03D800 030800 

03E000 03E000 

03E800 03E800 


00 NOT ADDRESSABLE 

00 NOT ADDRESSABLE 

00 NOT ADDRESSABLE 

00 NOT ADDRESSABLE 

00 NOT ADDRESSABLE 

00 NOT ADDRESSABLE 

00 NOT ADDRESSABLE 

00 NOT ADDRESSABLE 

00 NOT ADDRESSABLE 

00 NOT ADDRESSABLE 

00 NOT ADDRESSABLE 

00 NOT ADDRESSABLE 

00 CHANGED \ 

00 CHANGED / / / I / 

00 CHANGED ) 4-«U fori of 

00 CHANGED [ /' /. ' 

00 CHANGEO } 7C&K slMTayz 














O3FOO0 03F000 
03F800 03F800 
































/yi^mrKu^n trfcwtMt&x y£t*»n 










5w &?c<t+yi4e . 




r 


/7ce>* BLOCK 




. . /Zt~ 
toVoo 

/Z% 

ilooo 

/Jo 


A 






JwjX' J7&m& &*aL e*t*4%iv> 




\ -- ro/oj 


__ M>r usee 

lytao' 


tl. 




\09\S 




tlooo 


"1 

So 








Ml 


A/or Uitfi 


Si 


if 1 too 

/3f 








If lea 
Zoooo 








/uC&fk. 0/ /UzaJM a**/ 






iZ 

53 


7^ 


Mooo ,H 


J 














{ • 


Altr Viet 
/To *o 


r 


Sog-.o ~ ' 






















{ F«-V 
















*** SEGMENT TABLE *** 




*** PAGE TABLE 


*** L 






• ADDR. OF 
00E65C 


ST PT ENTRIES PT ORIGIN ADDR 
32 00E430 




VIRT.AODR REAL ADDR 
040000 020800 


KEY STATUS 
10 CHANGED 




) 


\ 












040800 019800 


10 CHANGEO 














041000 017800 


10 CHANGED 














041800 018000 


10 CHANGED 














042000 018800 


10 CHANGEO 














042800 


10 NOT USED 














043000 


10 NOT USED 














043800 


10 NOT USEO 














044000 


10 NOT USED 








S ■&&mtAvsC~ / 






044800 


10 NOT USED 












045000 


10 NOT USED 














045800 


10 NOT USED 














046000 


10 NOT USED 










BtjV 


046800 


10 NOT USEO 










047000 


10 NOT USED 












047800 


10 NOT USED 












048000 


10 NOT USED ] 














048800 


10 NOT USEO 














049000 


10 NOT USED 














049800 


10 NOT USED 














04A000 


10 NOT USEO 














04A800 


10 NOT USED 














O4B0O0 


10 NOT USEO 














04B800 


10 NOT USED 














04C000 


10 NOT USED 














04C800 


10 NOT USEO 














040000 


10 NOT USED 














04D800 


10 NOT USEO 














04E000 


10 NOT USED 














04E800 


10 NOT USED 














04F000 


10 NOT USED 












1 


04F800 


10 NOT USED 






(BentK^ 
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*** SEGMENT TABLE *** 






*** 


PAGE TABLE *** 

/ 




v A-e 






STATUS / 
CHANGED 




ADOR.OF ST PT ENTRIES PT ORIGIN ADDR 
00E668 32 00E5BO 




VIRT.AODR 
OAOOOO 


REAL ADDR KEY / 
028800 40 ~) / 






t 






FZV 


0A0800 


028000 40 L/ 


CHANGED 










OAIOOO 


02A800 40 | 


UNCHANGEO 












' 


OA1800 


02B000 40 > 
50 


UNCHANGEO 
NOT USED 






J 


i 


OA2000 










0A2800 


50 


NOT USED 














OA30OO 


50 


NOT USED 














OA3800 


50 


NOT USED 














0A4000 


50 


NOT USED 














OA480O 


50 


NOT USED 














OA5000 


50 


NOT USED 














OA5800 


50 


NOT USEO 














OA6000 


50 


NOT USED 








Seyyn&itA 4° 






OA6800 


50 


NOT USED 












0A7000 


50 


NOT USEO 








7^ 






0A7800 


50 


NOT USED 














0A8O00 


50 


NOT USEO 














OA880O 


50 


NOT USEO 














0A9000 


50 


NOT USEO 














0A9800 


50 


NOT USEO 














OAAOOO 


50 


NOT USED 














0AA800 


50 


NOT USED 














OABOOO 


50 


NOT USED 














0AB800 


50 


NOT USEO 














OACOOO 


50 


NOT USED 














0AC800 


50 


NOT USEO 














OAOOOO 


50 


NOT USEO 














OAD800 


50 


NOT USED 














OAEOOO 


50 


NOT USED 














OAE800 


50 


NOT USED 














OAFOOO 


50 


NOT USED 














OAF800 


50 

/ 

/v/r f~ 


NOT USEO 

/7 










n 


'/ 














*»* SEGMENT TABLE *** 






*** 


PAGE TABLE *** 










ADOR.OF ST PT ENTRIES PT ORIGIN ADDR 






VIRT.AODR 


REAL ADDR KEY 


STATUS 








OOE66C 32 00E5F0 






OBOOOO 
0B0800 
OB10OO 
0B1800 
0B2000 
0B2800 
OB3000 
0B3800 
0B4000 
0B4800 
OB5000 


50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 


NOT USED 
NOT USED 
NOT USEO 
NOT USEO 
NOT USED 
NOT USED 
NOT USED 
NOT USEO 
NOT USED 
NOT USED 
NOT USEO 








5 &yr»evtf // 






OB5800 


50 


NOT USED 












OB6000 


50 


NOT USEO 












0B6800 


50 


NOT USED 








/ 






OB70OO 


50 


NOT USED 














OB7800 


50 


NOT USED 














OB8000 


50 


NOT USED 














0B8800 


50 


NOT USEO 














OB9000 


50 


NOT USED 














0B9800 


50 


NOT USEO 














OBAOOO 


50 


NOT USEO 














0BA8OO 


50 


NOT USED 














OBBOOO 


50 


NOT USEO 














0BB80O 


50 


NOT USEO 














OBCOOO 


50 


NOT USEO 














0BC800 


50 


NOT USEO 














OBOOOO 


50 


NOT USEO 














0BD800 


50 


NOT USEO 














OBEOOO 


50 


NOT USEO 














0BE800 


50 


NOT USED 














OBFOOO 


50 


NOT USEO 






^^^^^^^ 




\ 


!.. 


08F800 


50 


NOT USEO 


&nwr 
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*** PAGE FRAME 


TABLE *** 






*» PFT EXT 


•* 












-FLAGS 


















ADDR.OF PFT 


FIX CNT 


NFF 


OR 


SP 


NF 


FORMARO-PTR 


BACKHARD-PTR 


PAGE NR 


ADDR.OF PAGE 


PFIX CNT 








~ OODE88 


00000 








1 









000 


000000 


000 








• 000E90 


00000 








1 









001 


000800 


000 








00DE98 


00000 








1 









002 


001000 


000 








m OOOEAO 


00000 








1 









003 


001800 


000 








• 00DEA8 


00000 








1 









004 


002000 


000 








OOOEBO 


00000 








1 









OOS 


002800 


000 








_ 00DE88 


00000 








1 









006 


003000 


000 








• OOOECO 


00000 








1 









007 


003800 


000 








0OOEC8 


00000 








1 









008 


004000 


000 








m OOOEDO 


ooooo 








1 









009 


004800 


000 








• 000E08 


00000 








1 









010 


005000 


000 








OOOEEO 


ooooo 








1 









Oil 


005800 


000 








_ O00EE8 


ooooo 








1 









012 


006000 


000 








• OOOEFO 


ooooo 








1 









013 


006800 


000 








OOOEF8 


ooooo 








1 









014 


007000 


000 








_ OOOFOO 


ooooo 








1 









015 


007800 


000 








• 0OOF08 


ooooo 








1 









016 


008000 


000 








O0DF10 


ooooo 








1 









017 


008800 


000 








~ 000F18 


ooooo 








1 









018 


009000 


000 








• OODF20 


ooooo 








1 









019 


009800 


000 








000F28 


ooooo 








1 









020 


OOAOOO 


000 








~ 00DF30 


ooooo 








1 









021 


00A800 


000 








• 00DF38 


ooooo 








1 









022 


OOBOOO 


000 








OODF40 


ooooo 








1 









023 


00B800 


000 








A 00DF48 


ooooo 








1 









024 


OOCOOO 


000 








• 0O0F5O 


ooooo 








1 









025 


00C800 


000 








00DF58 


ooooo 








1 









026 


000000 


000 








m OOOF60 


ooooo 








1 









027 


000800 


000 








• OO0F68 


ooooo 








1 









028 


OOEOOO 


000 








OODF70 


ooooo 








1 









029 


00E800 


000 








_ 0OOF78 


ooooo 








1 









030 


OOFOOO 


000 








• OO0F8O 


ooooo 








1 









031 


00F800 


000 








000F88 


ooooo 








1 









032 


010000 


000 








_ OOOF90 


ooooo 








1 









033 


010800 


000 








• 00DF98 


ooooo 








1 









034 


011000 


000 








OODFAO 


ooooo 








1 









035 


011800 


000 








m OOOFAB 

^ OODFBO 

000FB8 


ooooo 
ooooo 
ooooo 












1 
1 
1 











036 
037 
038 


012000 
012800 
013000 


000 
000 
000 


/ape fflumiL ctf aa6fre<H> 






m OOOFCO 


ooooo 








1 









039 


013800 


000 








• 000FC8 
OOOFOO 


ooooo 
ooooo 










1 
1 










040 
041 


014000 
014800 


000 
000 


£T0 1 O ctnM ooctJUeef 






m 00DF08 


ooooo 








1 









042 


015000 


000 


Off ka^jt, /3 Z h^*C/C 






• OODFEO 
00DFE8 


ooooo 
ooooo 










1 
1 










043 
044 


015800 
016000 


000 
000 






_ OODFFO 
• 00DFF8 


ooooo 
ooooo 










1 








00E068 


00E288 


045 
UNUSED 


016800 


000 
000 


A*o a. yir&leiiK OK&S&e+i 






OOEOOO 


00001 








1 









130 


041000 


000 








m 00E008 


00001 








1 









131 


041800 


000 


<rf ^Z,000 






• COOEOllD 


ooooo 














00E090 


OOE0C8 


(132) 


0)42000) 


000 






00E018 


ooooo 














00E078 


00E128 


315 


090800 


000 


J 




H?^ OOE02O 


ooooo 














0OE12 8 


OOEOFO 


129 


040800 


000 








O* 00E028 


ooooo 














00E098 


00E068 


UNUSED 




000 








0OE030 


ooooo 














0OE0D8 


00E048 


197 


062800 


000 








_ OOE038 


ooooo 














00E070 


OOEOAO 


310 


098000 


000 








• OOE040 


ooooo 














00EO48 


00E2A0 


199 


063800 


000 


















*** PAGE FRAME 


TABLE *** 






** PFT EXT 


** 












-FLAGS- 





















ADDR.OF PFT 


FIX CNT 


NFF 


DR 


SP 


NF 


FORWARD-PTR 


BACKMARD-PTR 


PAGE NR 


ADDR.OF PAGE 


PFIX CNT 








. 00E048 


ooooo 














00E030 


00E040 


198 


063000 


000 








• 00E050 


00001 








1 









194 


061000 


000 








00E058 


ooooo 














0OE2A0 


00E060 


195 


061800 


000 








_ 00E06O 


ooooo 














00E058 


00EO9O 


196 


062000 


000 








• 00E068 


ooooo 














00E028 


00DFF8 


UNUSED 




000 








O0E07O 


ooooo 














OOEOFO 


00E038 


311 


09B800 


000 








_ 00E078 


ooooo 














OOEOSO 


OOE018 


312 


09C000 


000 








• OOE080 


ooooo 














0OEO88 


00EO78 


313 


09C800 


000 








00E088 


ooooo 














OOEOBO 


OOEOSO 


314 


090000 


000 








m 00E090 


ooooo 














OOE060 


00EO10 


128 


040000 


000 








• 00EO98 


ooooo 














00E140 


00E028 


UNUSED 




000 








OOEOAO 


ooooo 














00E038 


00E138 


305 


098800 


000 








_ OOE0A8 


ooooo 














OOEODO 


00E120 


281 


08C800 


000 








• OOEOBO 


ooooo 














00E118 


O0EO88 


274 


089000 


000 








00E0B8 


ooooo 














OOEOEO 


O0E0O8 


277 


08A800 


000 








m OOEOCO 


ooooo 














O0E298 


00E118 


275 


089800 


000 








• 00E0C8 


ooooo 














00E010 


OOEODO 


279 


08B800 


000 








006000 


ooooo 














00E0C8 


00E0A8 


280 


O8CO00 


000 








m 00E0D8 


ooooo 














O0E0B8 


OOEOSO 


276 


O8AOO0 


000 








• OOEOEO 


ooooo 














00E12O 


00E0B8 


278 


08B000 


000 








00E0E8 


ooooo 














00E0F8 


00E298 


319 


09F800 


000 








m OOEOFO 


ooooo 














00E020 


00E070 


309 


09A800 


000 








• O0EOF8 


ooooo 














OOEIOO 


00E0E8 


318 


09F0O0 


000 








OOE100 


ooooo 














00E108 


00E0F8 


317 


09E800 


000 








. O0E108 


ooooo 














00E110 


OOEIOO 


321 


OA0800 


000 








• 00E110 


ooooo 














00E130 


00E108 


320 


OAOOOO 


000 








^^^^^JOEUB^^^ 


ooooo 


mL 








(> 


OOEOCO 


OOEOBO 


316 


09EOOO 


000 


^^^^^^^^^^^^^£mfjtr 
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Appendix H 

, u A . , x TABLES USED BY 

Job Accounting Interface J0B ACCOUNTING 

The Job Accounting Interface provides job step and job information that you can 
use for charging system use, supervising system operation, planning new applica- 
tions, etc. 

The job accounting option is supported when JA=YES in the FOPT supervisor 
generation macro. When this option is supported, the following tables are 
generated: 

• A job accounting interface partition table for each partition 

• A job accounting common table. 

Both tables are generated as part of the supervisor. 

The interface table is part of the partition table and provides user access to the 
job accounting routines and information. 

For each job step the following information is accumulated in this table: 

Job name 

User information 

Partition ID 

Cancel code 

Record type 

Date 

Job start time 

Phasename (from EXEC card) 

Highest address used (from communications region) 

CPU time 

Overhead time 

Stop time (at EOJ only) 

All bound time 

SIO count (optional). 
Note: If the CPU is not equipped with a timer, time fields are zero. 

To utilize this information, you must link -edit a routine to be relocatable by using 
the relocating loader option (or write a self-relocating routine) to store or print 
the desired portions of the table. This routine must be catalogued in the core image 
library under the name $JOBACCT. 

How to locate 

The address of the interface partition table is contained in bytes X'74'— X'77' of 
the partition communication region. 

The address of the common table is contained in bytes X'7C— X'7F' of 
SYSCOM. 
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This part of the 
table is for 
user reference 



< 





Displacement 


Label 


Description 






(ACCTABLE) 






-3 


ACCTWK1 


Work area used in SIO update 




4 -7 


ACCTWK2 


Work area used with ACCTWK1 in start/stop time routine 




8 -11 


ACCTSVPT 


Job card pointer; address of job card field following jobname 




12 


ACCTPART 


ID of partition in charge (partition switch name) 




13 


ACCTRES2 


Reserved 




14-15 


ACCTLEN 


Length of SIO area = 6n+1 , where n = number of devices for this 
partition in SYSGEN option JA = n1 , n2, n3, n4, n5) 




16-21 


ACCTLOAD 


Label area instruction; moves JAI label area address to OPEN/CLOSE 
transients 




22-23 


ACCTRES3 


Reserved 




24-27 


ACCTLADD 


Address of alternate label area 




28-31 


ACCTPUT 


Counter for CPU time elapsed in a jobstep, counted in 300ths 
of a second 




32-35 


ACCTOVHT 


Counter for overhead time: time not charged to any partition 




36-39 


ACCTBNDT 


Counter for all-bound time: system wait state time divided between 
running partitions 


f 


40-47 


ACCTSVJN 


Save area for job name during simulated EOJ 


48-55 


ACCTJBNM 


Job name; taken from job card 




56-71 


ACCTUSRS 


User information 16 bytes from job card 




72-73 


ACCTPTID 


Partition ID: 'BG', 'F4', 'F3\ 'F2'or 'FT in EBCDIC format 




74 


ACCTCNCL 


Cancel code; see Cancel Codes and Messages 




75 


ACCTYPER 


Type of record: 'S' = job step, 'L' = last step of job 




76-83 


ACCTDATE 


Date in format specified at SYSGEN (MM/DD/YY or DD/MM/YY) 




84-87 


ACCTSTRT 


Start time of job, in packed decimal (DHHMMSSF; F = sign) 




88-91 


ACCTSTOP 


Stop time of job, in same format as ACCTSTRT 




92-95 


ACCTR ES 


Reserved 




96-103 


ACCTEXEC 


Phase name taken from execute card 




104-107 


ACCTHICR 


End address of active program phase, from COMREG 




108-111 


ACCTIMES 


CPU time elapsed in a job step counted in 300th of a second 




112-115 




Overhead time: elapsed time not charged to any partition, in 300ths 










of a second 




116-119 





All-bound time: system wait state time divided between running 
partitions, in 300ths of a sec. 




120 


ACCTSIOS 


SIO tables: 6 bytes for each device specified by SYSGEN options, 
as follows: 2 bytes for device address (Ocuu), 4 bytes for count of 
SIOs in current jobstep. 









Overflow byte: normally X'20', but is X'30' if more devices are used 




K 






within a partition than specified by SYSGEN options 



Notes: DSECT ACCTABLE symbolically addresses the JAI Partition Tables with labels as shown. Each 
partition in which JAI is supported has its own JAI Partition Table, labeled ACCTBG, ACCTF4, 
ACCTF3, ACCTF2 and ACCTF1 for active partitions BG, F4, F3, F2,and F1 respectively. 
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Figure H-l . Explanation of the contents of the Job Accounting Interface partition table. 



Appendix H 



Displacement 


Label 


Description 




(ACCTCOMN) 




0-15 


ACCTSVRG 


Temporary register save area 


16-17 


ACCTSVRX 


Save area for remainder of overhead counter times 
distributed by partition on exit 


18-19 


ACCTSVRE 


Save area for remainder of all-bound counter times 
distributed by partitions on entry 


20-23 


ACCTPCNT 


Count of partitions using the Job Accounting interface 


24 


ACCTSAID 


Owner of physical transient area *) 


25 


ACCTFAID 


Interrupted program *) 


26 


ACCTRAID 


Active program *) 


27 


ACCTSWCH 


Accounting switches: if bit = 1 , true; if bit = 0, not true 
bit 0: cancel accounting bit 4: IPL indicator 
bit 1 : no active partitions bit 5: not used 
bit 2: catalog in process bit 6: not used 
bit 3: alternate label area bit 7: not used 


28-31 


ACCTIME 


Start time of current accounting interval, in complement 
format 


32-33 


ACCTRESC 


Reserved 


34-35 


ACCTUSEP 


Address of user save area (ACCTUSER) 


36-37 


ACCTUSEL 


Length of user save area (Set with 1st operand of FOPT 
macro parameter JALIOCS) 


38-39 


ACCTSJOB 


Job accounting partition indication 


40-43 


ACCTBLES 


Address of BG Job Accounting Table 



TABLES USED BY 
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If multiprogramming is supported, this table is to be extended with one of the 
following fields (depending on the number of supported partitions), otherwise the 
table ends here. 



44-47 Address of F1 Job Accounting Table 

48-51 ACCTSEAS Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



44-47 
48-51 
52-57 



44-47 
48-51 
52-55 
56-63 



44-47 
48-51 
52-55 
56-59 
60-69 



ACCTSEAS 



Address of F2 Job Accounting Table 

Address of F1 Job Accounting Table 

Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



ACCTSEAS 



Address of F3 Job Accounting Table 

Address of F2 Job Accounting Table 

Address of F1 Job Accounting Table 

Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



ACCTSEAS 



Address of F4 Job Accounting Table 

Address of F3 Job Accounting Table 

Address of F2 Job Accounting Table 

Address of F1 Job Accounting Table 

Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



*) These values are the same as the PIK values for the relevant tasks 

Figure H-2. Explanation of the contents of the Job Accounting common table. 



> IMP ARTS = 2 



NPARTS = 3 



^IMPARTS = 4 



^IMPARTS = 5 
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Programming considerations 

The user program for processing the information entered by the supervisor in the 
Job Accounting Table must be cataloged and be self relocating with the name 
SJOBACCT in a core image library. For efficiency, an overlay structure should be 
avoided, and the length of the program should preferably not exceed one core 
image library block. 

Because SJOBACCT is called in at the end of each job step, it should perform only 
data gathering and recording, but not data reduction and formatting if additional 
system overhead is to be held to a minimum. Overhead depends largely upon the 
efficiency of SJOBACCT. The optional SIO accounting (JA=nl , n2, n3) also 
causes additional overhead. 

LIOCS uses registers 13-15. If SJOBACCT needs any of these registers after a 
LIOCS function has been performed, save and restore the desired registers 
(register 14 should always be saved when using LIOCS because it is necessary to 
return to job control via the instruction BR 14). Chapter 9 in this section describes 
the usage of the general registers by system control programming and job accounting 

If SJOBACCT uses LIOCS, it should save at least part of the DTF information 
(status switches, extent information, and pointers) in the user save area. If more 
than one DTF is used, information from each should be saved. The user save area 
may be used to save any type of information as well as to accumulate step to 
step statistics for end job accounting. This accumulation reduces the rate of 
scheduled output records caused by writing a step accounting record for each job 
step. The user save area is not accessed by system functions. Chapter 12 in this 
section describes the save areas and the system generation macro JALIOCS. 

If an error causes SJOBACCT to be canceled, SJOBACCT is not called again until 
the system is re-IPLed. "JOB ACCT" appears in the cancel message, and the 
problem program name appear in the EOJ message. The STXIT option may be 
used to pass a message informing the operator that an error occured in SJOBACCT 
rather than in the problem program. (A description of tables used by user exit 
routines can be found in Section 4 of this manual, Chapter 10.) The job in that 
partition is terminated and normal processing continues with the next job. 

Refer to DOS 'jVS System Management Guide for details on writing job accounting 
routines. 
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This appendix describes the serviceability aids provided by IBM to a system 
programmer who suspects an error in the POWER or the POWER RJE (system 
control program). 

For a detailed description of the internal logic of the POWER and POWER RJE 
program refer to the POWER logic and POWER RJE logic manuals. 



Appendix J 

SERVICEABILITY 

AIDS FOR POWER 

AND POWER RJE 



Eliminating the components 

In the event of a suspected error in the POWER/POWER RJE program, the 
programs running under the control of POWER/POWER RJE should be executed 
without POWER/POWER RJE. That is, execute the programs under direct 
control of DOS/VS. In order to eliminate the POWER RJE component it may 
be necessary to submit your program to the central station and request it to be 
run without POWER RJE. 

If the identical error occurs, it is not caused by the POWER/POWER RJE SCP, 
and the failing program must be debugged. If the error does not occur when 
running under direct control of DOS/VS, it is possible that an error exists in the 
POWER/POWER RJE SCP. Whichever is the case, the flowcharts in part 1 of 
Section 4 should be consulted. These charts indicate which serviceability aid to 
use and recommend a method for analyzing the system information obtained. 



TRACE and DUMP Monitoring. 

If the identical error occurs, it can not therefore be caused by the POWER/POWER 
RJE SCP, and the failing program must be debugged. If the error does not occur 
when running under direct control of DOS/VS, it is possible that an error exists in 
the POWER/POWER RJE SCP. Whichever is the case, the flowcharts in part 1 of 
Section 4 should be consulted. These charts indicate which serviceability aid to 
use and recommend a method for analyzing the system information obtained. 



TRACE: Monitoring Tasks and SVCs. 

Tasks and/or SVC zero (SVC 00) are monitored if the operator issues an appropriate 
Z command. 



Z TRACE, 



SVC [,TSK] 
TSK 



Trace information is collected in a log table at the end of phase FGPTYPZ3, which 
is loaded for execution into a program buffer. To locate the log table in a dump of 
virtual storage, scan the two translated dump columns for the constant LOGADDR= 

Figure J.l shows the layout of the log table. The status of the trace can be 
displayed on the console by entering the command: 

Z TRACE. LST 



Figure J.l . The format and contents of the SVC and TSK log table. 
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/^\ X FF | = end of table 



SVC address 

SVC code (only SVC 00) 



1 2 „ 3 



address of TIB 

contents of TIBSTAT - seed and Q through |JJ of Figure K.1 of Appendix K 
contents of TIBACTN - see @ and through QjJ of Figure K.1. of Appendix K 
TIBID - see Q of Figure K.1 of Appendix K 



Figure J. 1 . The format and contents of the SVC and TSK log table. 
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DUMP: Monitoring TIBs, QFILE Records and DATAFIL Records 

The operator command whose format is shown below causes pointers contained in 
execution processor TIBs, in QFILE records, or in DATAFIL records to be 
monitored. The format of the command is: 

Ttib 

ZDUMP,<QFL [tiB~| [7dFL~| 

[dfl 

When TIB is specified, POWER/POWER RJE monitors the first and last queue 
pointers for all POWER/POWER RJE queues. The TIB fields containing these 
pointers are: 

• TIBRDRQF = pointer to the first JCT in the partition's reader queue 

• TIBRDRQL = pointer to the last JCT in the partition's reader queue 

• TIBPRTQF = pointer to the first JCT in the partition's print queue 

• TIBPRTQL = pointer to the last JCT in the partition's print queue 

• TIB PUNQF = pointers to the first JCT in the partition's punch queue 

• TIBPUNQL = pointers to the last JCT in the partition's punch queue 

• TIBPURGF = pointers to the first JCT in the partition's purge queue 

• TIBPURGB = pointers to the last JCT in the partition's purge queue. 

POWER/POWER RJE verifies that these pointers, which are in the format MCHR, 
are valid disk addresses within the QFILE extent. 

When QFL is specified, POWER/POWER RJE monitors: 

• in the QFILE master record, the first and last queue pointers for the reader, 
print, punch, and purge queues of all partitions 

• in the JCT being processed, the forward and backward chaining pointers. 
Refer to Appendix M for a description of the QFILE. 

POWER/POWER RJE verifies that these pointers are valid disk addresses within 
the QFILE extent and that no pointer in the QFILE master record appears on more 
than one queue. 

When DFL is specified, POWER/POWER RJE verifies that the DATAFIL record 
chain-pointer contains a valid disk address within the DATAFIL extent. 

When POWER/POWER RJE finds an invalid disk address, it causes an appropriate 
message to be displayed on the console. 

Contents of Registers 

An analysis of the register contents at the time of a dump occasionally provides a 
clue to the cause of the dump. Refer to Chapter 9 in Section 4 for a description 
of general usage for POWER and POWER RJE. 

The BIM (BTAM Interface Module) Simulator 

This is a software feature of the POWER RJE that simulates the function of the 
BTAM module. The simulator replaces the BIM for one RJE task in simulation 
mode, and any TPIO request from the task is serviced by the simulator on local 
unit record devices. All initialization procedures are performed for the task as if it 
were not in simulation mode. Some of these procedures are reversed to accommo- 
date the simulator. In particular, where the dynamic assignment is made for the 
line, the line is unassigned to permit the simulator to use the CCB in the Line 
Control Block for the card reader. The dynamic assignment is made in accordance 
with the specified card reader in the special start command. The print and punch 
functions are performed on the SYSLST and SYSPCH unit record devices assigned 
by job control during POWER initiation. By using the BIM simulator, execution of 
RJE task overlays may be divorced completely from any line activity, including 
BTAM execution. 
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A method of locating POWER control blocks and areas is shown in a series of 
illustrations in Figure K.l . part 1 through 9. Notes within these illustrations 
provide information that will help you in determining the status of the various 
POWER routines at the time the dump was taken in analyzing the contents of 
specific areas of bytes. 

The reference table below is provided to help you to locate descriptions shown in 
the following nine illustrations. 



Block or area to be located 


Reference 


The POWER partition (if it was 
active at the time the dump was taken) 


A 


POWER control blocks: 

GENSW (generation option table 

and switch) 

parameter list table 

DATABLKSand PROGBLKS 

table 

DCTs (device control tables) 

TIBTAB 

TIB 

3540 control block 


D 
D R 

R 

F 

C E 

E G-Q 

S 


Program buffers 


S 


Data buffers 


H 
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OThis area (described in Section 4 of this manual. Chapter 1 1 ) is neither used nor 
altered by the POWER program. If POWER was active immediately before the 
dump was taken, the area can be located as follows: 

If the MAP command was executed and is available on the SYSLOG output, the name 

of the job that initiated POWER will be printed together with the partition identifier 

and upper and lower addresses for that partition. The lower address is the address of 

the partition save area of the POWER partition. 

(Note that the address values printed by the MAP command are in decimal.) 

An alternative method is described below: 

1. Locate the BOUNDARY BOX in the dump as described in this manual. (Refer 
to Chapter 12 Section 4.) 

2. Make a note of the upper and lower partition addresses contained in the 
BOUNDARY BOX. 

3. Locate the PIB2 in the dump as described in this manual. (Refer to Chapter 7 
Section 4.) 

The PIB2 entry belonging to the partition containing POWER will have bit of byte 
1 5 set to 1 (X'80'), and the PI B2 entry belonging to partitions supported by POWER 
will have bit 1 of byte 1 5 set to 1 (X'40'> 

4. From this information and the contents of the BOUNDARY BOX you can locate 
the address of the partition save area of the partition containing POWER and of 
the partition supported by POWER. 

Note: If POWER was assembled with a unique name for the 
POWER generation macro, you can look up that name in 
the left of the translated dump columns. Otherwise the name 
is FGPSPOOL. 

The last eight bytes contain the name of the operator communication 
transient phase that has last been executing in the area. This name 
has the format 

FGPTYPxx 

where xx = phase identifiers. 

Examples of phase names: FGPTYPSO or FGPTYPL1. 



The address of the name can be calculated by adding X'400' to the address of 
the last byte of the partition save area. (The partition save area is either X'58' or 
X'78' bytes in length; refer to Section 4 in this manual. 
Chapter 11 for a description.) Subtract 8 from the result. 
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Figure K.l, part 1 of 9 



n 



xxxxxxxx 



DOS/VS partition save area 



Operator communication 
transient area of 1 K bytes 



FGPTYPxx 



E3 



POWER control blocks 



: Execution processor code: 
and common subroutines 



Supervisor-state 



Program 



buffers 



Data buffers 



w>m 
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OOS/VS partrtion save area 



I 






POWER control blocks 



and common subroutines 



• S##fy^-^ta^-!(jo^e- 



Pt atjraro buffers 



Data buffers 



m 



The following helps you locate the POWER control blocks. For full 
details about the fields of the control blocks, see Chapter 4. Data Areas. 



FESERVNO 

|* FESERVNO 156014 *DOS/VS POWER V.x.M.y | 



(hex) 00 



b-b 



N^ 2B 

V.x = version number 
M.y = modification level 



Locating this constant in the translated dump columns is a quick 
method of locating the beginning of the POWER control blocks area. 
FESERVNO (cont.) 



FESERVNO (cont.) 



(hex) 2C / 2F 30 / 33 34 I 37 38 




4B 4C 



Jj Analyze both the generation options and the generation option switch (GENSW) for the options specified. 



GENSW 



Generation options 



I 



□ 



38 39 3A 3B3C 3D 



L 



130 131 



the number of CCB's that can be used for unit 
record or tape I/O (MAXCCB) 

maximum number of data buffers that the POWER 
program can manage (MAXBUFS) 

maximum number of RJE tasks that can be started at 
one time (MAXRJS) 

maximum number of readers and writers that can be 
started at one time (MAXRW) 

•number of DATAFIL disks allowed (NUMDDKS) 

number of tracks in a track group (TRACKGP) 



I B 
I o 



Bit 


Meaning if 1 





autostart tor a reader task 


1 


autostart for a print writer task 


2 


autostart for a punch writer task 


3 


DIAG=YES 


4 


RJE=YES 


5 


reserved 


6 


READER=YES 


7 


READER=YES 





TAPE=YES 


1 


RDRCLOS=EXIT 


2 


ACCOUNT=YES 


3 


RJEND=YES 


4 


JOBSEP=YES 


5-7 


reserved 



Figure K.l, part 2 of 9 
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Examine the TIBTAB to determine which tasks are active and which are ready to receive control. 



(hex) 2C / 2F 38 




.. ^ i. ^^ 

/ / Generation options / (see |i| I 



TIBTAB 



Device control tah\e$ 
(DCTs) 



-4 Pormer- 



Nowork task 



Operator communications task 



QFILE task 



DATAFIL 
tasks 



Private SSL task 



System SSL task 



ACCTFIL task 



Execution 
processor tasks 



Reader and 
writer tasks 



to COREBLKS table (which consists of the DATABLKS and PROGBLKS 
tables) 



as many as disk volumes were specified in the NUMDDKS generation 
parameter 



V only present if SLI=YES was specified 

\ only present if ACCOUNT=YES was specified 

► one per POWER supported partition in specified priority sequence 

► as many as were specified in the MAXRW generation parameter 



Format of a TJ0TA0 entry: 



I 



TSB Task entry point 



Look up the associated TIB 



Pointer to TIB 



M 



Wi 



task s^actfon/ bytfev 

. X'QO: « t3$*c is inactlvf fa& task exists fori sh'fo- TtSTAB er#$ . . : 
iX'OV = task is active and either has control or is waiting for an I/O 

event to occur 
W- *s tssfc-ts *q*e»y*tt tff&fri&'&M$t& whan 4i ta&*& t^njghaf. 

p> »&rity : . csnh0t fe€»>yfi:: : con1;ro( 



Figure K. 1 , part 3 of 9 
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Locate DCTs and analyze access queues: 



DEVICETB 



TIBTAB 



Private SSL DCT 



System SSL DCT 



ACCTFILDCT 



QFILE DCT 



DATAFIL DCTs 



Unit-record and 
tape DCTs 



Pointer to 
QFILE DCT 



Pointer to 
CORESLKS 



only present if SLI=YES and a private SSL is assigned 

only present if SLI=YES 

only present if ACCOUNT=YES 



. as many as disk volumes were specified in the NUMDDKS 
generation parameter 



. as many as disk volumes were specified in the MAXCCB 
generation parameter 



TIBTAB table 



f 



The following is an illustration of a DCT access queue with three TIBs waiting to do I/O to the same DCT: 

DQPRTB DQPTRC 

1 



(hex) 00 




Figure K.l , part 4 of 9 
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Except for the TIBs for reader and writer tasks, all TIBs are located in the POWER control blocks area of the 
POWER partition. The TIB for a reader or writer task is located in the program buffers (seeEI) allocated 
to the task. 



TIBACTN 



TIBSTAT 



TIBCHARD 






mm 



(hex) 00 



ttiiiiiiiiiiiiiiMiil 



L 



Identifies the type of the associated task: 

$OP = operator communication task 

bpp = execution processor task for the indicated 
partition :seeQ| 

ppP = punch writer task for the pp partition 
ppR = reader task for the pp partition 
ppT = print writer task for the pp partition 

XXP = partition-independent punch writer task 
XXR = partition-independent reader task 
XXT = partition-independent print writer task 

where pp = partition identification: BG for background, 
F1 through F4 for foreground 1 through 4 

Indicates the action performed by the task when the 
error occurred: 

For an execution processor TIB: see Q 

For a reader TIB: see Q 

For a print writer TIB: see Q 

For a punch writer TIB: see |Qj 

For the operator communication TIB: see |J| 



Indicates why the task gave up the CPU or, if it has 
control of the CPU, that the last I/O performed was 
completed: 

For an execution processor TIB: see Q 

For a reader TIB: see Q 

For a print writer TIB: see Q 

For a punch writer TIB: see Q 

For the operator communication TIB: see ^J 



Figure K.1, part 5 of 9. 
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Execution processor TIB. To locate an execution processor TIB see Q 
Input from SYSRDR. 



(hex) 00 




TIBRDRA TIBRDRB2 



First (or only) data buffer for input 
from SYSRDR. Size of buffer depends 
on value specified in the POWER 
generation parameter DBLK. 



BWPI|?pill 



74 



77 



t t 



I t 



Second data buffer (if used) for input 
from SYSRDR. Size of buffer 
depends on value specified in the 
POWER generation parameter DBLK. 




First (or only) data buffer for output 
to SYSLST. Size of buffer depends 
on value specified in the POWER 
generation parameter DBLK. 



t 


Second data buffer (if used) for 
output to SYSLST. Size of buffer 
depends on value specified in the 
POWER generation parameter DBLK. 


size 1 


\ 



Output to SYSPCH: 

TIBPUNCH 



TIBPNCHA 



TIBPUNB2 



n rru 

(hex) 00 




First (or only) data buffer for output 
to SYSPCH. Size of buffer depends 
on value specified in the POWER 
generation parameter DBLK. 



t 

1 SZe 1 



Figure K.l, part 6 of 9. 
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1 



DF 



i r 

I size I 

I 



Second data buffer (if used) for 
output to SYSPCH. Size of buffer 
depends on value specified in the 
POWER generation parameter DBLK. 



TIBSTAT of an execution processor TIB: 

Bit Meaning 

1 = SYSLST output for the current job entry will not be 

intercepted. 

1 reserved. 

2 1 = SYSPCH output for the current job entry will not be 

intercepted. 

3 1 = end-of-job processing for the current job entry takes place. 

4 1 = printed output is being intercepted. 

5 reserved. 

6 1 = punched output is being intercepted. 

7 1 = a job is being executed. 
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13 TIBSTAT of a reader TIB: 



Bit Meaning 

1 = task is going to be terminated. 

1 reserved. 

2 1 = Sequence of DISKETTE volumes is to be checked. 

3 reserved . 

4 1 = task is reading from a 3450. 

5 1 = both a card reader and a 3540 are assigned. 

6 reserved. 

7 1 = task is to be cancelled. 



TIBSTAT of a print writer TIB: 



Bit 

0-1 



Meaning 

10 = a stop command has been issued for the task. 

01 = a flush command for the current job has been issued for 
the task. 

1 1 = a restart command for the current job has been issued 

for the task. 
1 = a flush all command has been issued for the task. 
1 = the writer has completed output for the current job. 
1 = restart command directs the task to start from the 

beginning of the current job. 
reserved. 
1 = indicates to a tape writer that job separator pages are 

required. 
1 = a cancel command has been issued for the task 



Figure K.l , part 7 of 9. 
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U2| TIBSTAT of a punch writer TIB: 



Bit Meaning 

1 = a stop command has been issued for the task. 

1 1 = a flush command for the current job has been issued for the 

task. 

2 1 = a flush all command has been issued for the task. 

3 1 = the writer has completed output for the current job. 
4-6 reserved. 

7 1 = a cancel command has been issued for the task. 

171 TIBSTAT of the operator communications task TIB: 

Bit Meaning 

0-6 Reserved. 

7 POWER command is entered while a previous command is being 

executed. 

p^ TIBACTN of an execution processor TIB: 

XW = disk I/O was in progress or just completed if the task was in control of the CPU. 
X'04' = the contents of a print or punch buffer are to be printed or punched, 

respectively. 
X'08' = a POWER EOJ card is to be processed. 
X'0C = an input card is to be read. 
X'10' = a PRT card is to be processed. 
X'1 4' = a PUN card is to be processed. 
X"I8' = a message is being written on the console. 
X'1 C = either a JOB card (writer-only system) or an SLI card (reader system) is to be 

processed. 
X'20' = a card from the Source Statement library is to be processed. 

fjl TIBACTN of a reader or writer TIB: 

X'00' = disk I/O was in progress op just completed if the task was in control of the CPU. 
X'04' = the task waits for work. This code is set by the execution processor for the 
same partition: 

— for a reader task when all card input for a job is complete 

— for a writer task when all print (or punch) output for a job is complete. 
X'08' = The task waits for completion of 

— a read operation on the associated card reader if a reader task. 

— a print operation on the associated printer if a print writer task. 

— a punch operation on the associated card punch if a punch writer task. 
X'1 8' — The task has issued a message to the console and waits for completion of the 

typing operation. 

Itf| TIBACTN of the operator communication TIB: 

X'00' = disk I/O was in progress or just completed if the task was in control of the CPU. 
X'04' = The task is inactive, that is, all commands have been processed. 
X'08' = the task has received a command and has initiated processing of same. 
X'10' = I/O for the ACCTFIL is in progress. 

X'1 8' = the task has initialized writing a message on the console and waits for completion 
of the typing operation. 



Note: For POWER start up, the TIBACTN code has been assembled as X'08' and the TSB of the 
associated TIB TAB entry has been assembled at X'03'. 



Figure K.l, part 8 of 9. 
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1K 
bytes 



OOS/VS paffettort say* ares 



Operator boniimuniQation 
tra«steflt, ar«* . 



ANALYZING A DUMP 

OF THE POWER 

PARTITION 

Locate the program and data buffers by means of 
pointers in the parameter list table and in the PROGBLKS 
and DATABLKS tables: 



COMMONDT 



POWER control blocks 



j Parameter fist t&ftfe /|f 



(hex) 00 



48 



4B 4C 



4F 



B-CJ 



Execution processor code and 
common subroutines 



Supervisor-state code 









PROGBLKS 


SB 


Pointer to program buffer 




SB 


Pointer to program buffer 






; 




SB 


Pointer to program buffer 



L 



SB = Status byte: 

X'00' = buffer not used 
X'03' = buffer used or 
no buffer exists 



Program buffers 



S 



Oata buffers 



DATABLKS 


SB 


Pointer to data buffer 






* 




SB 


Pointer to data buffer 



Program buffers are generated only for reader and writer tasks. The number of program buffers generated 
is equal to the number specified in the MAXRW generation parameter. The format of a program 
buffer as shown below in the illustration on the left. The illustration on the right shows that two program 
buffers are acquired by a reader task using the 3540 as input reader. 



TIB for task (see Q ) 



Phase entry and exit code 
(identical for all phases 
of a task) 



Phase code 



FGPSPOLx 



2K 

bytes 



Name of phase executing 
in the buffer, where 
x = phase identifier. 
The name's address is: 
A(TIB)+X'400'-8 



TIB for task (seeQ) 



Phase entry and exit code 
(identical for all phases 
of the task) 



Phase code 



FGPSPOLx 



3540 control block 



Name of phase executing in' 
the buffer, where 
x = phase identifier. 



Figure K.1, part 9 of 9. 



In a dump, the translated 
phase name can be used to 
locate the 3540 control 
block. > 



> 
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The method of locating POWER/RJE control blocks and areas is shown in a series 
of illustrations in Figure L.l, parts 1 through 14. Notes within this figure provide 
information that will help you in determining the status a POWER/RJE task had 
at the time the dump was taken and in analyzing the contents of specific areas or 
bytes. 

The table below assumes that you have successfully located the POWER partition 
either (1) by tracing its beginning from the pointer in the active partition to the 
partition's save area or (2) by locating in the translated dump column the name you 
have used for the generation macro at the time of POWER/RJE assembly. 

The table does not include the steps that must be taken in order to locate normal 
POWER control blocks, such as an execution processor TIB or a reader or writer 
TIB, nor does it include information about how to analyze these POWER control 
blocks. For this information refer to Appendix K or the DOS/VS POWER Program 
Logic Manual. 

The reference table below is provided as a help in locating the information which 
you need to find a specific block or area in a dump. In the illustration, always look 
for the given reference to the left of text. 



Block or area to be located 


Reference to the Illustrations 


CCB (in DTFBT) 


M 


DTFBT 


M 


DECB (data event control block) 


J 


Generation options table 


D 


Parameter list table 


D 


RJEBLK (RJE block) 


H 


RJBLKLST (RJE block name list) 


K 


RJE TIB (RJE task information block) 


G 


RJLIST (RJE active task list) 


F 


RJUSERS (RJE list of authorized users) 


L 


TIBTAB (task information block table) 


D 
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If the POWER/ RJE program was assembled with a unique name for the 
generation macro you can look up that name in the left of the translated 
dump columns. 
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A 1 K area used for the execution of the operator communication 
transient phases. The last eight bytes contain the name of the phase 
that has been executing in the area. This name has the format 

FGPTYPxx 

where xx = phase identifiers 



The address of the name is 
A (partition save area) 



/ X'78' \ v , 
+ \X'58'| + X 



400-8 



* FESERVNO 156014 *DOS/VS POWER v.d.M.d 



Generation Option table 



(hex) 14 



2B 2C 



5-J 



Q V.d. = program version number 

M.d. = program modification number 

Locating this constant in the translated dump columns is a quick 
method of locatingthe beginning of the POWER/RJE control 
blocks area. 



xxxxxxxx 



? 



DOS/VS partition save 
area 



Operator communication 
transient area 



FGPTYPxx 



8TMOO 
N«J8tM30> 



I Illlll M l M l MM 

RJ€ block name 
ttst {RJBLKUST* 



User ID list 
(RJUSERS) 



POWER/RJE control 
blocks 



Execution processor 

code and common subroutines 

I U n i U I IHHim il Hl l iil l H<«. I W^> w*» *i <i hiini<, 



Supervisor-state cod* 



P^^ro buffers 



i m i 1 1 1 1 1 1 1 1 1 1 1 1 ii rr i n i n i ii i i . i i . i 1 1 ii 1 1 1 M i M 1 1 1 1 1 1 1 i n i . i 



Data buffers 

iiiiiiiiiiiiiiiiiiiiiiiiiii^^ 



(hex) 2C/ 2F 30 / 33 34 




Figure L.l, part 1 of 14 



Generation options 



3D 



^Analyze both the generation option switch and the options in the table. 
For details, see Q\ 



@ For full details about the fields of the table, see the "Data Area" section. 
For important switches, see Q 
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\§M continued 



© 



Generation option table 



(hex) 2C 



from beginning 
of FGPSPOOL 
CSECT (resident 
POWER code) 



(hex) 00 



34 



1!W5SfKWi 



37 38 39 3A 3B 3C 3D 



L 



tfca number of CCB'a that car* be used for ut*H 
laisoctfar t$m l/0 : l&A&CCBJh .' . •• 

■maximum t»«*ober of data ^ffws th»i: ^ POVy6« : ; 

maximum number of RJE tasks that can be started at 
one time (MAXRJS) 

rti^XHftum ncwflbef 0? ce&daFa.ang wsfcers that ^jgb^ 
itarted &t 4W& t»A4 {MAXRW) 

5$i$p^^ 



I^ararr>«t9r fist tabte 



i 



GENSW HP 



130 131 



: Bit Meaning ft 1 

H artostsrt for a raader task was specified 
! t autostart for a pru*t writer task was 
: -a:'- a^loatart for a p*moh writer ta&Ij; was 
; -3 ; : ; Di A<$** YES was specif ied • 

4 RJ Ess YES was specified 



$ rt£AO£ft*»¥&& wea Specified 

7 R€AOEft«Y£S waa apaetead 

i 8&RCtO$*£XIT waa apaatf ied 

.2 ACCOU*t?~Y£Swa* specified 

3 RJE is included (MAXRJS=1 to 5 was specified) 

4 JOBSEP* YES was specified 



Figure L.l, part 2 of 14 
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■MM* 

(hex) 00 



[. Parameter a$t table //| 



1D4 



JT~T-1 

1F2 

L 



TYPEIN+X'1 E': indicates buffers obtained for RJE task 
initiation 

Bits Meaning if 1 

0-2 reserved 

3 BIM's turnaroud data buffer obtained 

4 BIM program buffers obtained 

5 task s data buffer obtained 

6 RJEBLK program buffer obtained 

7 RJE task program buffer obtained 

Note: These switches are used only by FGPTYPS1 
and FGPTYPS2 

TYPEIN: 

X'00' = phase FGPTYPBO has finished executing 

X'FF' = an additional track group must be obtained 
for RJE messages, and the tracks of that 
group must be initialized as free message 
records. 

Note: This switch is used only by phases FGPTYPBO, 

FGTYPB1, and FGPTYPB2. 



Task ownership byte 




II 



(hex) 00 



60 61 



63 64 65 



67 






address of the BIM simulator if the preceding byte 
is # X'00' 

X'00' = the BIM simulator is not in storage and the 

next three bytes are insignificant 
not X'00' - the BIM simulator is in storage 
(see Note below) 

address of BIM if the preceding byte is # X'00' 

X'00' = the BIM is not in storage and the next 

three bytes are insignificant 
not X'00' = the BIM is in storage 



Figure L.l, part 3 of 14 



Note: Each time a task requests the services of the BIM (or BIM simulator), 
the contents of the task ownership byte are shifted to the left by one bit 
position and bit 7 of the byte is set to 1 . Each time a task finished using 
the BIM (or BIM simulator), the contents of the task ownership byte are 
shifted to the right by one bit position and bit of the byte is set to 0. 
A copy of the byte's bit configuration for a specific task is contained in 
the RJBLKLST entry for that task (seeQ ). 
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Generation options table 



2C 




37 38 



TIBTAB 



-0C 



Nowork task 



Op. communication task 



QFILE task 



DATAFIL 
tasks 



Private SSL task 



System SSL task 



ACCTFIL task 



Execution 
processor 
tasks 



RJE tasks 
(up to five) 



Reader and 
writer tasks 



*> 



1 (see Q and Q ) 



3D 

to QFILE DCT 

to RJLIST (see Q ) 
to COREBLKS table 



as many as disk volumes were specified in the 
NUMDDKS generation parameter 



only present if SLI=YES was specified 

only present if ACCOUNT=YES was specified 



one per POWER supported partition in specified 
priority sequence 



as many as were specified in the MAXRW 
generation parameter 



Format of a TiBTAB entry. 



TSB 



Task entry point 



*S!K!*Sfc 



Address of TIB 



!*S 



—4 h 

4 5 



m 



Look up the 
associated 



• X 

TIB/ 



b 



: X'OQ'»» task «s * naetwe foci taste ^xi*ts fc^ thi^ TIBTAB 6rrtry). 
*H|X01 = task is active and either has control or is waiting for an I/O event to occur gfi 

, XW ' « . »sk fe *e«dy to. wcttm control *fa*n. «H itasfc* of hmhm prte&ti Gwtmt. r «?o*v« 
. xW * unit *eeofO mrm t4c&v$iy pm&£#<i % m &<#&$&$ . 



Figure L.l, part 4 of 14 
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(see H ) 



Q only if the task is active; set to F'O' otherwise 



RJLIST* 



-*• eight bytes • ► 


Address of DECB 


Address of TIB 


Address of DECB 


Address of TIB 


Address of DECB 


Address of TIB 


Address of DECB 


Address of TIB 


Address of DECB 


Address of TIB 


X'FF' 


Reserved 


n 


Address of 2780 BIM 


n 


Address. of BIM SIM 


Address of RJBLKLST 


Address of RJUSERS 


Address of RJBTMOD 



X'FF' = indicates the end of the list 

* contains as many entries as RJE tasks were specified in the MAXR 
Figure L.l, part 5 of 14 
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TIBTAB 



| RJL1ST "f / | j Register 7* | 

1 Ocuuxxxx 



* only if the associated task is active 



RJE TIB 



L 



name of RJE block that contains the RJE TIB (for further details about the RJE block, see Q ) 



cuu = line address at the central station 

xxxx = type of terminal used: 2770, 2780, or 3780 



iiiiiiiiililfl 

(hex) 



TIBACTN 



TIBSTAT 



TIBCHARD 



-111 



1D 



1E 



1F 



21 



L 



contains the characters RJE 



Bit Meaning if 1 

stop the task 

1 flush the TP input and write a message to the 
work station operator 

2 a TP input record is available (a TPIO READ 
cannot be issued) 

3 (only if a 2780 is used) the first record in the 
data buffers has a space-immediate CCW and 
is preceded by a print-no-space CCW as the 
last record of the buffer used previosly 

4-7 reserved 



X'00' = disk I/O was in progress or just completed if 

the task was in control of the CPU 
X'04' = the task waits for work 
X'07' = a TP READ INITIAL has been issued 
X'08' = a TIPO other than read initial has been issued 
X'18' = the task has issued a message to the console 
and waits for completion of the typing 
operation 



Figure L.1, part 6 of 14 

A.54 Appendixes. 



Appendix L 

ANALYZING A DUMP 

OF THE POWER RJE 

PARTITION 



continued 



r.'Mfei* / I 



■TIBCODES (10 bytes) 



(hex) 



22 



26 



2B 



TIBCODES+4: indicates the transfer of control 
between the OUTPUT work station command 
processor, the print overlays and the punch overlays: 



X'16 
X'18 



X'1C 



X'10' = print operations are in progress 
X'14' = punch operations are in progress or to be 
processed for an ALLUSERS request 
= a punch job is to be placed in the hold state 
= punched output is available for an 

ALLUSERS request or a jobname request if 
the JCT userid field is ALLUSERS 
= the print overlays have transferred control 
directly to the punch overlays or punched 
output is available for userid for a jobname 
request 
X'30' = the punch overlays have transferred control 
directly to the print overlays or printed 
output is available for userid for a jobname 
request 
X'38' = printed output available for an ALLUSERS 
request or a jobname request if the JCT 
userid field is ALLUSERS 
= a print job is to be placed in the hold state 
= a print job is to be placed in local state for 
processing at a local output device 
X'70' = a print job is to be placed in local state for 
processing at a local output device 



X'50' 
X'60' 



TIBCODES (10 bytes) 



(hex) 22 



28 



2B 



TIBCODES+6: contains the address of the next TP 
input record or the data portion for TP output (this 
field is altered only by the BIM) 



Figure L.l, part 7 of 14 



Appendixes. A.55 



Appendix L 

ANALYZING A DUMP 
OF THE POWER RJE 
PARTITION 



continued 



•TIBRDRWQ (4 bytes) 



:fUETI» // I 



(hex) 




Bit Meaning if 1 

0-5 reserved 

6 termination of reader overlay has been requested 

7 reserved 



0-3 
4 
5 
6 

7 

0-1 
2 
3 
4 



reserved 

the first record read was a JOB statement 

end-of-file on TP 

request for a track group is to be forced 

no track group found 

reserved 

a DOS/ VS job card was read 

FGPPRJE4 was called by FGPPRJEY 

an EOJ JECL statement is being moved to the 

data block 

an input record is available ( a TPIO READ 

cannot be issued) 

the first record is in a disk buffer 

a JOB JECL statement was read (JECL must 

control when the end of a job entry has been 

reached, not a DOS/VS /& statement). 



(hex) 



TIBRDRB2 



TIBRDMR 



74 



77 78 



7B 



pointer to next available position for a logical record 
in the current data block 

-pointer to DECB used by the associated task 
(see HI for details) 



Figure L.l, part 8 of 14 
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mmrmmmmrrmmmmmtL •* 



ft 



■TIBPRINT (40 bytes) 






(hex) 



80 81 83 84 



87 A7 



address of last BTAM I/O - used for retries 

address of BIM being used 

C'R' = the task is in read mode 
C'W = the task is in write mode 

* X'00' = the switched line is disconnected 

* X'02' = an EOT received (no line disconnect) 
*X'04' = intervention is required at the work station 

* X'40' = stop was requested when a TPIO macro 

was issued 

* X'80' = an irrecoverable error has taken place 
*X'81' = timeout has occurred at the work station 

and the user session is terminated 

* settings that arise from TP exceptions when the 
task's TP exception routine is entered 



-TIBPRINT (40 bytes)- 



t fettle i ( i f :- rr 

(hex) 80 8C A7 



"} 



TIBPRINT+12: its bits are set by the TPCOMPL 
routine to indicate to the BIM that an exception has 
taken place: 
Bits Meaning if 1 

TPCOMPL has been entered 

1 an exception has taken place 

2 stop was requested since last TPIO was issued 
3-7 reserved 



Figure L.l, part 9 of 14 
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fustm / I 



• TIBPRINT (40 bytes)- 



li 



iWUHW NM4 






(hex) 



80 



8D 8E 8F 



A7 



TIBPRINT +15 indicates input and TP buffer status: 
Bits Meaning if 1 

last block from DATAFIL was used to fill the 
TP I/O area 

1 input in TP I/O area was from a BTAM read 

2 last print block is in TP I/O area 

3 intervention required on print (EOT) 

4 the end of a data block was reached when the 

TP area was last filled with input stored on disk 

5 input in TP area is from the DATAFIL 
intermediate storage 

6 input is being transferred to a data block during 
TP read-to-write line turnaround 

7 input has been stored on the DATAFIL 

TIBPRINT+14 indicates the TPIO function 
requested when the BIM was last entered: 

X'02' - read 

X'04' = detach 

X'05' = punch 

X'06' = print 

X'07' = flush the input and write to the work station 

operator 
X'08' = write to the work station operator 
X'09' = open the RJE task DTFBT 
X'OA' = close the RJE task DTFBT 

TIBPRINT+13 indicates line direction : 

X'00' = line is not initialized or is in control mode 
X'OV = CPU is receiving 
X'02' = CPU is transmitting punch records 
X'04' = CPU is transmitting print records 
X'08' = CPU is transmitting a message 



Figure L.l, part 10 of 14 
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Register 7 * j * only if the associated task is active 



RJE TIB (see for details) 



DECB (see PJ for details) 



I/O area 



DTFBT (see QQ for details) 



DcuuxxxxA 



RiETIB 



II 



(hex) 




77 



Note: For full details about switches maintained by 
BTAM, see the manual DOS Basic Telecommunications 
Access Methods, GC27-6989 



II 



(hex) 00 



09 



0C 



28 29 



2B 



pointer to RJLIST (see Q ) 

X'00' = task does not operate in simulation mode 
X'OV - task operates in simulation mode 

pointer to the DTFBT (see (23 ) 

bit 1 is used to indicate the following: 

if = the task has control of the CPU or is waiting 

for a TP operation to complete 
if 1 = the task is ready to run 



Figure L.l, part 11 of 14 
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IB continued 



(hex) 



PNTRJBLK 



PNTTERM 



PNTUSER 



DEVCHAR 



m 



2C 



2F 30 31 33 34 37 38 3B. 



' i r~ 






(hex) 00 



0D OF 



L 



pointer to userid entry (in RJUSERS) representing 
the user currently logged on (for the format of a 
userid entry, see Q ) 

pointer to userid entry ( in RJUSERS) representing 
the accepted termid in the last acknowledged 
RJSTART command 

pointer to the RJBLKLST (RJE block name list) entry 
used to initiate the task (for the format on an 
RJBLKLST entry, seeQ) 

work station status: 

X'00' = inactive 

X'OT = attached, but no user logged on 

X'03' = attached and processing (user is logged on) 

pointer to task ownership mask in BlM pointer 
behind the RJ LIST (see H) 



pointer to the I/O area 



I om II I 



PNTRJBLK 



PPIWPWWWfWPI^P^P^^PW^^ 



30 / 33 



[ 



J B L K L S T 

/■ V >:v, r -,:f ■-:■:-: f ■:■:■■ t ,■ ,,-:■■,. ; ■■ ■;. |t , ., ■■ 



(hex) 00 03 04 07 08 



OF 



length of RJBLKLST 

number of entries (identical with number of RJE 
blocks) 



| RJBLKLST l l 



■>« first RJE block name entry- 



Block name 



•7 bytes - 



(hex) 00 



10 



17 18 1B1C ID 1F 



If 



Q second and succeeding RJE block name entries 
Figure L. 1 , part 1 2 of 1 4 
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• X'FF' = end of li 



list 



pointer to DECB used by the associated RJE task 
(only valid if the preceding byte is # X'00' ) 



task's BlM ownership mask 



Appendix L 

ANALYZING A DUMP 

OF THE POWER RJE 

PARTITION 






FNTRJBtK I 



PNTTERM 



PNTUSER 



(hex) 



30 



33 34 35 V 37 38 



1 



3B 



R J U S E 8 5- 

.it ti.iiniii.i ..I I, 1 1 it M i 



(hex) 00 



03 04 



07 08 



II 



OF 




Entries in RJUSERS table 



X'40' 

length of RJUSERS 



mmmrnmrnt. 



RJUSERS entry 



Userid or Term id 



(hex) 00 



10 



17 18 1B 1C IF 



_ 



L 



number of entries (three bytes) 
X'FF' = end of list 
pointer to second DECB, if used 
pointer to first DECB 



^^ second and succeeding RJUSERS entries; each of 
these entries has the same length as the first one 



(hex) 09 / 0C 




see 



First LCB (line control block)* 



(hex) 00 01 



JPD 



* all LCBs of a system have the same length 

length of an LCB 

number of LCBs contained in the DTFBT 



Figure L.l, part 13 of 14 
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continued 



o 



CCB (command control block) 



(hex) 00 



28 2A 2B2C 



31 



S3 



37 



pointer to the first CCW in the channel program 
a copy of the CSW status bytes 

Bit Meaning if 1 

data check in count area (OASD) 

1 track overrun (DASO) 

2 end of cylinder (DASD) 

3 2540 equipment check 

4 questionable condition 

5 reserved 

6 carriage channel 9 or verify error for OASD 

7 reserved 

traffic (wait) bit 

1 flag bit 

2 unrecoverable I/O error 

3 acceptable unrecoverable I/O error 

4 return DASD data checks to user 

5 post at device end 

6 return DASD data checks on count, read 
command, or verify command 

7 user error routine exists 

residual count from the CSW 



Figure L.1, part 14 of 14 
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ANALYZING A DUMP OF 

THE POWER/POWER RJE 

QFILE 



Analyzing a QFI LE Dump 

A dump of the POWER disk file QFI LE can be very helpful if, for example, the POWER 
program failed because of a disk I/O error. Although analyzing the JCTs in the various queues 
may not isolate a problem, it may provide hints on how to define the problem still further. 
Figure M.1 parts 1 and 2 are provided to help you in analyzing a QFILE dump. 



Byte 
(in hex) 



4 



CC 
DO 



QFILE 
master record 



E8 




first JCT in print queue 
last JCT in print queue 
first JCT in punch queue 
last JCT in punch queue 
first JCT in reader queue 
last JCT in reader queue 
first JCT in purge queue 
last JCT in purge queue 



There is one such set of pointers for each POWER supported 
partition. These sets of pointers are arranged in the same 
sequence as the supported partitions were specified in the 
POWPART parameter of the POWER generation macro. 



Note: For 3330/3333 MCHR means the following: 



Record number 




Halfword containing the displace- 
ment into the data block. 



Head number 

= Cylinder number is less then 256 

1 = Cylinder number is 256 or higher 
eight low-order bits of the cylinder number 

POWER system logical unit number 



Figure M.l, part 1 of 2 
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Structure of a hypothetical QFILE (only one queue is shown): 



rD- 



QFILE master record £S;3i^& JCT JCT 



S- 



o 



l ' ' V_J\ 



wmm jct 



JCT 



rem 



JCT 



JiM Layout of a QFILE master record (for further details refer to Figure 5.3): 



C±ZMI 



pointers 



(hex) 



1C 



CB CC 



^ If ACCOUNT=YES was specified for POWER generation, this field points to the next available ACCTFIL 
record; otherwise the field is set to zero. 



[|J Layout of a JCT (for further details refer to Figure 4.4): 



?. i ? i v/r: i . @ -iiiiiir^^r 4 h-^ P"^i 



(hex) 



8 9 



OC OD OE 



20 21 22 23 



0) Contains the DOS/VS or POWER job name; if no job name was specified, the field contains the character 
string AUTONAME. 

Q Contains the POWER assigned job number. 

{y Each of the bytes contains either CD' or C'H': 

D = dispatch (the job is ready for processing by the proper task) 
H = hold (the job is in the hold state) 

Byte OC: indicates the job's status in the reader queue. 
Byte OD: indicates the job's status in the printer queue. 
Byte OE: indicates the job's status in the punch queue. 

(?) Identifies the associated partition: BG, F1, F2, F3, or F4. 
A Contains the class of the job's print or punch output. 



Figure M. 1 , part 2 of 2 
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The online terminal test for the IBM 2780 and 2770 is an optional service provided 
by BTAM. It is provided to ensure proper operation of the system, and it may be 
used in the diagnosis and correction of a terminal malfunction. BTAM recognizes 
Request-for-Test messages transmitted by the remote work station. When an RFT 
message is recognized, BTAM performs the requested test, which is usually 
transmission of a tewt message. 

The BSC online test facility recognizes Request-for-Test message only if: 

1 . BSCTEST=YES is coded in the RJE/BTMOD macro. 

2. TERMTST=YES is coded in the RJEBLK macro that assembles the DTFBT. 

3. The operation is a Read Initial. 

4. The application program issued a TWAIT with TERMTST=YES following the 
macro instruction that was executing when the RFT was received. 

5. If a 2770 terminal: 

a. The ONLINE TEST button is pressed. 

6. The RFT message is received without error. 

Because BTAM only recognizes RFT messages on a Read Initial, the RFT card must 
be read within 28 seconds to be received without error. Failure to submit the card 
within 28 seconds requires the user to send an RJSTART and RJEND card. The 
RJE task must issue a Read Initial before any RFT cards will be accepted. The on- 
line test facility is described in the DOS/VS Basic Telecommunications Access >d 
Method manual (GC27 - 6989). 

The online test facility prints the results of the test on the computer console. Two 
messages are provided; one is used when BTAM is transmitting test messages (or 
RFT messages with X=0), the other when BTAM is receiving test messages. The 
content of these messages is: 

Transmitter Receiver 

Line Address Line Address 

Number of Transmissions (Y) Number of Transmissions 

X Field X Field 

Time-outs Time-outs 

NAK's Received Lost Data Occurrences 

Terminal ID (multipoint) Data Checks 
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The formats of these messages are: 

for the transmitter: 

4B70I ON-LINE TEST cuu xx yy TO NK TI 

for the receiver: 

4B7 II ON-LINE TEST cuu xx yy TO LD DC 

where: 

4B70I identifies the messages as BSC online test results for the transmitter. 

4B71I identifies the message as BSC online test results for the receiver. 

cuu specifies the line in the form channel and unit. 

xx specifies the test type. This is the X field from the RFT message. 

yy specifies the number of transmissions. For the transmitter, this value is the 
value from the RFT message. For the receiver, this value is accumulated by the 
online test program. If online test was not successfully initiated, this field will 
contain zero. 

TO specifies the number of time-out occurrences. 

NK specifies the number of NAK's received by the transmitter. 

TI for multipoint lines, specifies the terminal ID; for point-to-point lines, it is 
blank or specifies the component selection sequence received with the RFT. 

LD specifies the number of occurrences of lost data. 

DC specifies the number of occurrences of data check. 

The following online test procedures may be used for switched and leased-line 
IBM 2780s. 
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2780 ONLINE TESTS CONTENTION - PRINT 

Before operating these tests be sure that the customer's program has the online test 
features option in. Do not try to run these tests if online test in the customer's 
program is not available. 2780 setup: 

1. Place the Operate/Test switch on the data set cable and the CE panel in the 
operate position. 

2. Turn the Mode switch on the 2780 operator console to the TRANSMIT 
position. 

3. Flip the Online Test Switch on the CE panel to the ON position. 

4. Place the RFT (request for test message) card into the hopper. 

5. Ready the printer. 

6. Depress the Serial Reader Punch Start key to begin the test. 

SOH %01 PRINT TEST 

The purpose of this test is to transmit a test message card to the CPU. The CPU 
then transmits the data back to the 2780 that was contained in cc 8-80 of the 
test message card. The CPU sends this message to the 2780 as many times as 
indicated by the punch in cc 5 and 6 of the test message card. 

Format is as follows: 

Col Punches Character 

Indicates this card is an RFT (request for test 
message) card. 

Indicates the type of test requested. 

Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

This is the message the CPU will send back 
to the 2780. Columns 1 1-79 can contain any 
non-control characters. The ETX is shown in 
column 80, but it may be placed anywhere in 
the RFT card to denote the end of the message. 

This test should run to the 2780 without error indications. The data contained 
in cc 1 1—79 should print with single spacing the number of times indicated by 
cc 5 and 6. 



1 


12 


-1 


-9 


SOH 


2 


0- 


4- 


8 


% 


3 












4 


1 






1 


5 








Y 


6 








Y 


7 












8 


12 


-2- 


-9 


STX 


9 


0- 


7- 


9 


ESC 


10 


0- 


1 






11 










80 


12- 


-3- 


-9 


ETX 



Appendixes. A.67 



Appendix N 

ONLINE TERMINAL 
TEST FOR THE 
IBM 2780/2770 



SOH % 12 PRINT TESTS 

The purpose of this test is to request that a stored message from the CPU be sent 
to the 2780 terminal. The 12 designation indicates which transmission code the 
2780 terminal has that is requesting the test (EBCDIC). 

Format is as follows: 



:oi 


Pur 


lch 


es 


Character 


l 

2 


12- 
0-' 


-1- 
4- 


-9 

8 


SOH 

% 


3 
4 








1 

2 


5 
6 








Y 
Y 


7 












8 
9 


12- 
12- 


-2- 
-3- 


-9 
-9 


STX 

ETX 



Identifies this card as an RFT (request for test 
message) card. 

These columns designate a request for a 
stored message. 

Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

Ending sequence required by the CPU program. 



The following message will print in the 2780 without any errors. The message will 
be single-spaced and print the number of times indicated by cc 5 and 6 of the test 
message card. Each print line should look like this: 

ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 
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2780 ONLINE TESTS CONTENTION - PUNCH 

Before running these tests be sure that the customer's program has online test option 
in. Do not try to run these tests if online test feature is not available. 2780 setup: 

1. If the 2780 has the AutoTurnaround feature, depress the AutoTurnaround 
switch to place the 2780 in AutoTurnaround mode. If the 2780 does not have 
AutoTurnaround, install the following cards into the B gate: 



Appendix N 
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Card Location 6— Bit 



02B1B20 
02B1C34 
02B1C35 
02B1C36 
02B1C37 
02B1C38 
02B1C39 



None 

DGV (370378) 
DGT (370380) 
DGU (370379) 
DGV (370379) 
DHC (370372) 
AJW (370643) 



EBCDIC 

AJW (370643) 
DHC (370372) 
DGV (370378) 
DGT (370380) 
DGU (370379) 
DHC (370372) 
DHC (370372) 



USASCII 

None 

DGV (370378) 

DGT (370380) 

DGT (370380) 

DGV (370379) 

DHC (370372) 

None 



Note: The cards to be installed are the special test SMS cards included in the 2780 
shipping group. These cards must be removed before returning the 2780 to 
the customer. 

2. Place the Operate/Test switch on the 2780 data set cable and the CE panel into 
the operate position. 

3. Turn the Mode switch on the 2780 operator console to the transmit position. 

4. Flip the Online Test switch located on the CE panel to the ON position. 

5. Place the RFT (request for test message) card and a deck of blank cards into 
the hopper. 

6. Depress the Serial Reader Punch Start key to begin the test. 



SOH%01 PUNCH TEST 



The purpose of this test is to transmit a test message card to the CPU. The CPU 
then transmits data to the 2780 that was contained in cc 8—80 of the test message 
card. The CPU will send this message as many times as indicated by the punching 
in cc 5 and 6 of the test message card. The 2780 automatically reverts to punch 
mode because AutoTurnaround was activated, or because the CE test SMS cards 
were installed as described in step 1 . 



Form; 


at is as follows 




Col 


Punches 


Character 


1 

2 


12-1-9 
0-4-8 


SOH 

% 


3 
4 



1 



1 


5 
6 




Y 

Y 


7 








8 

9 

10 

11 

80 


12-2-9 

0-7-9 

4 


STX 
ESC 

4 



Identifies this card as an RFT (request for 
test message) card. 

Indicates the type of test requested. 



Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

This is the message the CPU will send back to 
the 2780. Any non-control characters can be 
punched in cc 1 1—80. 



This test should operate to the 2780 with no error indications. The 2780 should 
punch the data contained in cc 1 1—80 of the RFT card in cc 1—69 of the punched 
output card. 
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SOH % 13 PUNCH TEST 

The purpose of this test to request that a stored message from the CPU be sent to 
the 2780 terminal. The 13 designation indicates which transmission code is to be 
used. The 2780 automatically reverts to punch mode because the AutoTurnaround 
feature was activated or because the CE test SMS cards were installed as described 
in step 1 . 



Format 


is as follows 




Col 


Punches 


Character 


1 

2 


12-1-9 
0-4-8 


SOH 

% 


3 
4 




1 
3 


5 
6 




Y 
Y 


7 








8 


12-2-9 


STX 



Identifies this card as an RFT (request for test 
message) card. 

These columns indicate a request for a 
stored message. 

Indicates the number of times that a test 
is requested (01—99). 

Denotes a contention terminal. 

Ending sequence required by the CPU. 



The 2780 should punch the following data into cc 1—36 of the output cards as 
many times as indicated by cc 5 and 6 of the test message card. No errors should 
occur. 

ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 

Note: Each punched output data card will be followed by a blank card. This is a 
normal indication caused by the way the 2780 reverts to AutoTurnaround 
mode. 
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2770 ONLINE TESTS CONTENTION - PRINT 

Before operating these tests be sure that the customer's program has the online test 
features option in. Do not try to run these tests if online test in the customer's 
program is not available. 2770 setup: 

1. Turn the "Transparency" switch on the 2772 console off. 

2. Place the RFT (request for test message) card into the hopper. 

3. Press Check Reset and Term Reset at the 2772 console. 

4. Press START at the card reader. 

5. Press the ON Line Test button at the 2772 console. 

SOH% 01 PRINT TEST 

The purpose of this test is to transmit a test message card to the CPU. The CPU then 
transmits the data back to the 2770 that was contained in cc 8—80 of the test 
message card. The CPU sends this message to the 2770 as many times as indicated 
by the punch in cc 5 and 6 of the test message card. 



Format 


is as follows 




Col 


Punches 


Character 


1 


12-1-9 


SOH 


2 


0-4-8 


% 


3 








4 


1 


1 


5 




Y 


6 




Y 


7 








8 


12-2-9 


STX 


9 


0-7-9 


ESC 


10 


0-1 




11 






80 


12-3-9 


ETX 



Indicates this card is a RFT (request for 
test message) card. 

Indicates the type of test requested. 

Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

This is the message the CPU will send back 
to the 2770. Columns 1 1—79 can contain any 
non-control characters. The ETX is shown in 
column 80, but it may be placed anywhere in 
the RFT card to denote the end of the message. 

This test should run to the 2770 without error indications. The data contained 
in cc 1 1—79 should print with single spacing the number of times indicated by 
cc 5 and 6. 
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SOH % 12 PRINT TESTS 

The purpose of this test is to request that a stored message from the CPU be sent 
to the 2770 terminal. The 12 designation indicates which transmission code the 
2770 terminal has that is requesting the test (EBCDIC). 



Format 


is as follows 




Col 


Punches 


Character 


1 

2 


12-1-9 
0-4-8 


SOH 

% 


3 
4 




1 

2 


5 
6 




Y 
Y 


7 








8 
9 


12-2-9 
12-3-9 


STX 
ETX 



Identifies this card as an RFT (request for 
test message) card. 

These columns designate a request for a stored 
message. 

Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

Ending sequence required by the CPU program.. 



The following message will print in the 2770 without any errors. The message will 
be single-spaced and print the number of times indicated by cc 5 and 6 of the test 
message card. Each print line should look like this: 

ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 



A.72 Appendixes. 



Appendix N 
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Before operating these tests, be sure that the customer's program has the online ' °M 2780/2770 

tests option in. Do not try to run these tests if ED 60 or Online feature is not 
available. 2770 setup: 

1. Turn the "Transparency" switch on the 2772 console off. 

2. Place the RFT (request for test message) card into the hopper. 

3. Press Check Reset and Term Reset at the 2772 console. 

4. Press START at the card reader. 

5. Press the On Line Test button at the 2772 console. 

SOH % 00 TRANSMIT TEST 

The purpose of this test is to allow the 2770 to transmit a deck of test cards to the 
CPU. The CPU responds with a DLE sequence if no error occurred during trans- 
mission; the CPU responds with a NAK if a CRC or VRC error occurred. There is 
no response for any other type of error. 

Format is as follows: 

Col Punches Character 

1 12-1-9 SOH Indicates that this is an RFT (request 

2 0—4—8 % for test message) card. 

3 Indicates the type of test required. 

4 

5 For this test, 01 is the Only allowable 

6 1 1 number of messages to be sent (see note). 

7 Denotes the contention terminal. 

8 12—2—9 STX Data to be sent as a test. Columns 9—79 can 

contain any non-control characters. 

80 12-3-9 ETX Last card only. 

Note: Columns 5 and 6 of the transmit test must he 01. In order to transmit more 
than one card, a deck of cards must be punched with the same control 
characters in cc 1-8 and cc 80 of the test message card. Any non-control 
characters can be punched in cc 9- 79. Place this deck into the hopper and 
hold the start key depressed until a buffer is read. If the start key is not held 
depressed, only one card will be sent by the 2770. 

The test messages should be transmitted to the CPU and accepted by it without any 
errors. The audible alarm will sound for a short period after each card and will 
remain on at the end of this test. 
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SOH % 15 OR 16 WEAK DIBIT TEST 

The purpose of this test is to request a stored message from the CPU. A stored 
message transmits the worst-case conditions for the data set and communication 
lines. When the RFT (request for test message) card has been transmitter and the 
audible alarm sounds, the 2780 mode switch should be turned to the print or 
punch position and either unit made ready. The output message (weak dibit) will 
then be printed or punched depending upon the position of Mode switch. 

Note: The user has 6 seconds to ready the output unit after the Mode switch is 
turned to the print or punch position. 

Format is as follows: 



Col 



Punches Character 



1 


12-1-9 


SOH 


2 


0-4-8 


% 


3 
4 




X 
X 


5 




Y 


6 




Y 


7 








8 


12-2-9 


STX 


9 


12-3-9 


ETX 



Identifies this as an RFT (request for test message) 
card. 

Identifies the type of stored message we are 
requesting (see note). 

Indicates the number of times we are 
requesting the test (01—99). 

Denotes a contention terminal. 

Ending sequence required by the CPU. 



Note: Columns 3 and 4 should be punched according to the transmission code and 
tine facilities of the terminal involved. 



Transmission Code 


Column 3 


Column 4 


EBCDIC switched or IBM clock 


1 


5 


EBCDIC leased line 


1 


6 



The 2780 should print or punch the weak dibit message as many times as indicated 
by cc 5 and 6 on a test message card. No errors should occur during the test. If line 
errors occur during this test but not during any of the other online tests, the data 
set or communications line may be failing. The dibit characters may not print or may 
print as something else. Operating with no line check is the basic goal of this test. 
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2770 ONLINE TESTS CONTENTION - PUNCH 

Before running these tests be sure that the customer's program has online test 
option in. Do not try to run these tests if online test feature is not available. 
2770 setup: 

1. Be sure POWER is on for the 545 card punch and that it is initialized. 

2. Turn the "Transparency" switch on the 2772 console off. 

3. Place the RFT (request for test message) card into the hopper. 

4. Press Check Reset and Term Reset as the 2772 console. 

5. Press START at the card reader. 

6. Press the On Line Test button at the 2772 console. 



SOH %01 PUNCH TEST 

The purpose of this test is to transmit a test message card to the CPU. The CPU 
then transmits data to the 2770 that was contained in cc 8—80 of the test message 
card. The CPU will send this message as many times as indicated by the punching 
in cc 5 and 6 of the test message card. The 2770 automatically reverts to punch 
mode. 



Format 


is as follows 




Col 


Punches 


Character 


1 

2 


12-1-9 
0-4-8 


SOH 

% 


3 
4 



1 




1 


5 
6 




Y 
Y 


7 








8 

9 

10 

11 

80 


12-2-9 

0-7-9 

4 


STX 
ESC 

4 



Identifies this card as an RFT (request for test 
message) card. 

Indicates the type of test requested. 



Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

This is the message the CPU will send back 
to the 2770. Any non-control characters can 
be punched in cc 1 1—80. 



This test should operate to the 2770 with no error indications. The 2780 should 
punch the data contained in cc 1 1—80 of the RFT card in cc 1—69 of the punched 
output card. 

Note: Each punched output data card will be followed by a blank card. 
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Appendix N 

ONLINE TERMINAL 
TEST FOR THE 
IBM 2780/2770 



SOH % 13 PUNCH TEST 

The purpose of this test to request that a stored message from the CPU be sent to 
the 2770 terminal. The 13 designation indicates which transmission code is to be 
used. The 2770 automatically reverts to punch mode. 

Format is as follows: 



Col 



Punches Character 



Identifies this card as an RFT (request for 
test message) card. 

These columns indicate a request for a 
stored message. 

Indicates the number of times that a test 
is requested (01—99). 

Denotes a contention terminal. 

Ending sequence required by the CPU. 



The 2770 should punch the following data into cc 1—36 of the output cards as 
many times as indicated by cc 5 and 6 of the test message card. No errors should 
occur. 

ABCDEFGHIJKLMNOPQRSTUVWXYZ01 23456789 



1 

2 


12-1-9 
0-4-8 


SOH 

% 


3 
4 




1 

3 


5 
6 




Y 

Y 


7 








8 


12-2-9 


STX 
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2780 ONLINE TESTS CONTENTION - TRANSMIT AND WEAK DIBIT 

Before operating these tests, be sure that the customer's program has the online 
tests option in Do not try to run these tests if ED 60 or Online feature is not 
available. 2780 setup: 

1. Place the Operate/Test switch on the data set cable and on the 2780 CE panel 
to the operate position. 

2. Turn the Mode switch on the 2780 console to the transmit position. 

3. Flip the Online Test switch located on the CE panel into the ON position. 

4. Place the RFT (request for test message) card or cards into the hopper. 

5. Depress the Serial Reader Punch Start key to begin the test. 

The following online test procedures may be used for switched and leased-line 
IBM 2770s. 



SOH % 00 TRANSMIT TEST 

The purpose of this test is to allow the 2780 to transmit a deck of test cards to 
the CPU. The CPU responds with a DLE sequence if no error occurred during 
transmission; the CPU responds with a NAK if a CRC or VRC error occurred. 
There is no response for any other type of error. 

Format is as follows: 

Col Punches Character 

1 12-1-9 SOH Indicated that this is an RFT (request 

2 0-4-8 % for test message) card. 

3 Indicates the type of test required. 

4 

5 For this test, 01 is the only allowable 

6 1 1 number of messages to be sent (see note). 

7 Denotes a contention terminal. 

8 12-2-9 STX Data to be sent as a test. Columns 9-79 can 

contain any non-control characters. 

80 12-3-9 ETX Last card only. 

Note: Columns 5 and 6 of the transmit test must be 01. In order to transmit more 
than one card, a deck of cards must be punched with the same control 
characters in cc 1-8 and cc 80 of the test message card. Any non-control 
characters can be punched in cc 9—79. Place this deck into the hopper and 
hold the start key depressed until a buffer is read. If the start key is not 
held depressed, only one card will be sent by the 2780. 

The test messages should be transmitted to the CPU and accepted by it without 
any errors. The audible alarm will sound for a short period after each card and 
will remain on at the end of this test. 



Appendix N 

ONLINE TERMINAL 

TEST FOR THE 

IBM 2780/2770 
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Appendix O 

PROCESSING TAPE ERROR 
STATISTICS USING EREP 



You can cause detailed or summarized tape statistics to be printed through the use 
of the various combinations of EREP options shown in Figure F-3-D in Section 2-F 
of this manual. The summarized format combines the individual recordings (for 
example, Unit Check, Volume Dismount, and End-of-Day records) either by volume 
serial number or by tape unit, and prints the summarized statistics. The detail format 
prints each recording in either volume serial number format or tape unit format. 
Whenever detail or summarized data is printed in volume serial number format, the 
data is printed in sequence by volume serial number. 

Example 1 : Print detail tape error statistics from SYSREC. The information is 
printed in the format of record 4 of the example printout below. Enter the following 
job control statements: 

// EXEC EREP 
OPTION TES,NOTAPE,PRINT 

/* 

Example 2: Print the summarized tape error statistics from SYSREC only. The data 
is printed in the format of record 3 of the example printout below. Enter the 
following job control statements: 

// EXEC EREP 
OPTION TES,NOTAPE,SUM 

/* 

Example 3: Print the detail tape error records and then print their summary by 
volume serial number. The data is printed in the format of records 1 and 3 of the 
example printout below. The following job control statements: 

//EXEC EREP 
OPTION TES,NOTAPE,PRINT,SUM,SUMTAPE, VOL 

/* 

A work tape is required because the VOL option is specified-The work tape will 
contain a sequential list of all volume serial numbers along with a 5-byte disk 
address for each of these numbers. The message 

3E08A MOUNT SCRATCH TAPE ON SYS008 

is printed on SYSLOG. After the scratch tape is mounted the operator should 
respond END. If the operator chooses not to mount a work tape, he should respond 
CANCEL END. This causes the SUM and PRINT TES options to be canceled. Any 
other response results in the messages 

3E25I INVALID RESPONSE 

3E08A MOUNT SCRATCH TAPE ON SYS008 

being printed on SYSLOG. 



A.78 Appendixes. 



Example 4: Update the TES history tape on SYS007 . Then a scratch tape is 
mounted on SYS008. The error records are edited and printed from SYSRES onto 
SYSLST in the detail volume serial number format (record 2 of the example print- 
out below). The tape error records on the history tape are then summarized and 
printed on SYSLST in the summarized volume serial number format (record 1 of 
the example printout below). Enter the following job control statements: 

// LBLTYP TAPE 
// TLBL EREPNEW 
// EXEC EREP 

OPTION HIST 

OPTION TES,PRINT,SUM,SUMTAPE,VOL 
/* 

First the TES history tape is updated: the message 

3E09 A MOUNT TES HISTORY TAPE ON SYS007 

is printed on SYSLOG. After the TES history tape has been updated, the tape error 
data on SYSREC is edited. The message 

3E08A MOUNT SCRATCH TAPE ON SYS008 

is printed on SYSLOG. The tape data is printed on SYSLOG and then the message 

3E18A MOUNT HISTORY/RDE TAPE 

is printed on SYSLOG. The history tape is read and the tape error data is sum- 
marized by volume serial number. Finally, the history tape is updated and the 
SYSREC file is cleared. 



Appendix O 

PROCESSING TAPE ERROR 
STATISTICS USING EREP 




An example of the EREP TES print formats. 
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Appendix P 

EXAMPLES OF THE 
SUM OPTION OF EREP 



Note: This option of 
EREP is only applic- 
able to the Model 145 



Example 1 : The job control statements required for a summary of the SYSREC file 
by disk, tape, unit record, and TP groups are: 

// EXEC EREP 
OPTION SUM 
GROUP=DISK,TAPE,UNITREC,TP 

/* 

Example 2: The control statements required for a summary of the SYSREC file 
by MICR/OCR, CPU, and 27 1 5 hardware groups are: 

// EXEC EREP 
OPTION SUM 
GROUP=MICR/OCR,CPU,27 1 5 

/* 

The 2715 groups is summarized first 



Example 3: job entered through SYSIPT requesting the RDE Summary Option 

// JOB EXAMPLE 

// ASSGN SYS009,X'283' 

// TLBL EREPNEW 

// LBLTYP TAPE 

// EXEC EREP 

OPTION SELECT ,TAPE 

DEVICE=2314 

CUA=0134 
OPTION RDESUM 

OPTION RDESUM 

OPTION EDIT 
/* 
/& 

The RDE summary parameters will be requested on SYSLOG. 



A.80 Appendixes 
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This glossary contains technical terms associated with the subject of this publication. A more general range of terms 
is contained in IBM Date Processing Glossary, GC20- 1 699. 

IBM is grateful to the American National Standards Institute (ANSI) for permission to reprint its definitions from the 
American National Standard Vocabulary for information Processing (copyright © 1970 by American National Standards 
Institute, Incorporated) which was prepared by subcommittee X3K5 on Terminology and Glossary of American 
National Standards Committee X3. These definitions are indicated by an asterisk. 



A 



B 



address translation. The process of changing the 
address of an item of data or an instruction from its 
virtual address to its real storage address. See also 
dynamic address translation. 

asynchronous, without regular time relationship. 

auxiliary storage. Data storage other than real 
storage; for example, storage on magnetic tape or 
disk. Synonymous with external storage, secondary 
storage. 



basic control mode. When PSW bit 12 is 0, PSW 

format and system operation are compatible with 
standard System/ 360 operation. This is the basic 
control mode in which control registers 0, 8, and 
14 are available to the system. Abbreviated to BC 
mode. See also "Extended Control Mode." 

BTAM (basic telecommunications access method). 

A basic access method that permits a READ/WRITE 
communication with remote devices. 

buffer. (1) A storage device in which data is 
assembled temporarily during data transfer. (2) During 
I/O operations, a portion of real storage into which 
data is read or from which data is written. 



channel program. One or more Channel Command 
Words (CCWs) that control(s) a specific sequence 
of channel operations. Execution of the specific 
sequence is initiated by a single start I/O instruction. 

channel program translation. In a channel program, 
replacement, by software, of virtual addresses with 
real addresses. 

command control block (CCB). A 1 6-byte field 
required for each channel program executed by 
physical IOCS. This field is used for communication 
between physical IOCS and the problem program. 

communication region. An area of the supervisor 
set aside for interprogram and intraprogram communi- 
cation. It contains information useful to both the 
supervisor and the problem program. Abbreviated 
comreg. (Not to be confused with the COMRG macro 
instruction). 



control program. A program that is designed to 
schedule and supervise the performance of data 
processing work by a computing system. 

control registers. A set of registers used for operating 
system control of relocation, priority interruption, 
program event recording, error recovery, and masking 
operations. 

core-wrap mode. The method of operation that 
records the events of a trace in the PD area or an 
alternate area (used by PDAIDS). It is the default 
process when no output device for a PDAID trace 
has been specified. 



D 



DTF (define the file) macro instruction. A macro 
instruction that describes the characteristics of a 
logical input/output file, indicates the type of 
processing for the file, and specifies the I/O areas 
and routines to process the file. 

default value. The choice among exclusive alternatives 
made by the system when no explicit choice is 
specified by the user. A default value is indicated by 
underlining in tables listing parameters. 

diskette. A flexible magnetic oxide coated disk, 
permanently enclosed in a semi-rigid protective 
plastic jacket approx, 8 inches square. During data 
processing operations the disk turns freely within 
the jacket. It is capable of storing 1898 128 character 
data records. 

dump. (1) To print out the contents of all or part 
of virtual storage or of auxiliary storage (2) The 
data resulting from the process as in (1). 

dynamic address translation (DAT). (1) The change 
of a virtual storage address to an address in real 
storage during execution of an instruction. (2) A 
hardware feature that performs the translation. 



emulator (1) * A device or computer program that 
emulates. (2) The combination of programming 
techniques and special machine features that permits 
a given computing system to execute programs 
written for another system. 
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environmental recording, editing, and printing 

(EREP). A program that processes the data 
contained on the system recorder file. 
error recovery procedures. Procedures designed to 
help isolate, and, when possible, to recover from 
hardware errors in equipment. The procedures are 
often used in conjunction with programs that record 
the statistics of machine malfunctions. 

error volume analysis (EVA). With this option, the 
system issues a message to the operator when a 
number of temporary read or write errors (specified 
by the user at system generation time) has been 
exceeded on a currently accessed tape file. 

event. An occurrence of significance to a task; 
typically, the completion of an asynchronous 
operation, such as input/ output. 

extent. The physical locations on Input/Output 
devices occupied by or reserved for a particular 
volume. 

extended control mode. When PSW bit 12 is set to 1 , 

the PSW format is changed from that used for 
standard System/360 operation: the channel mask 
bits, instruction length code, and interruption code 
are removed, and additional mode and mask bits are 
included. This is the extended control mode, in 
which all control registers are available to the system 
for control of facilities that are particular to System/ 370. 
Abbreviated to EC mode. See also "Basic Control Mode." 



fetch. (1) To bring a program phase into real storage 
from a core image library or from the page data set 
for immediate execution. (2) The routine that 
retrieves requested phases and loads them. (3) The 
name of a macro instruction (FETCH) used to 
transfer control to the system loader. (4) To transfer 
control to the system loader. 

* file. A collection of related records treated as a unit. 
For example, one line of an invoice may form an item, 
a complete invoice may form a record, the complete 
set of such records may form a file, the collection of 
inventory control files may form a library, and the 
libraries used by an organization are known as its 
data bank. 

fixed page. A page in real storage that is not to be 
paged out. 

F/L Trace (Fetch/Load Trace). A program that 
records information about phases and transients as 
they are called from a core image library. 



I 



G 



GSVC Trace (Generalized Supervisor Calls Trace). 

A program that records SVC interrupts as they occur. 
All or a selected group of SVCs can be traced. 



H 

hard copy. A printed copy of machine output in a 
visually readable form, for example, a printed 
recording of the messages displayed on the System/370 
Model 125 video display unit. 

hard stop. A condition, usually caused by an error, 
in which the CPU is stopped and is not executing the 
microprogram. 

* hardware. Physical equipment, as opposed to the 
computer program or method of use, for example, 
mechanical, magnetic, electrical, or electronic devices. 
Contrast with software. 

Input Job Stream. A sequence of job control state- 
ments entering the system, which may also include 
input data. 

* interface. A shared boundary. An interface might 
be a hardware component to link two devices or it 
might be a portion of storage or registers accessed by 
two or more computer programs. 

interrupt. A break in the normal sequence of 
instruction execution. It causes an automatic transfer 
to a preset storage location where appropriate 
action is taken. 

invalid page. A page that cannot be directly addressed 
by the dynamic address translation feature of the 
central processing unit. 

I/O area. An area (portion) of real storage into which 
data is read or from which data is written, the term 
buffer is often used in place of I/O area. 

I/O Trace (Input/Output Trace). A program that 
records I/O device activity for all or a selected group 
of I/O devices. 

IOCS (input/output control system). A group of 
macro instruction routines provided by IBM for 
handling the transfer of data between main storage 
and external storage devices. 

irrecoverable error. A hardware error which cannot 
be recovered from by the normal hardware and retry 
procedures. 
J 

job. (1) * A specified group of tasks prescribed as a 
unit of work for a computer. By extension, a job 
usually includes all necessary computer programs, 
linkages, files, and instructions to the operating 
system. (2) A collection of related problem programs, 
identified in the input stream by a JOB statement 
followed by one or more EXEC statements. 
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linkage editor. A processing program that prepares 
the output of language translators for execution. It 
combines separately produced object or load modules; 
resolves symbolic cross references among them, and 
generates overlay structures on request; and produces 
executable code (a load module) that is ready to be 
fetched into virtual storage. 

load. In programming, to enter instructions or data 
into storage or working registers. In DOS/VS, to bring 
a program phase from a core image library into virtual 
storage for execution. 

logic module. The logical IOCS routine that provides 
an interface between a processing program and 
physical IOCS. 

loop. A sequence of instructions that is executed 
repeatedly until a terminal condition prevails. 

LSERV (label cylinder display). A program that 
formats a listing of the label cylinder located on 
SYSRES. 



M 



machine check analysis and recovery. A feature that 
checks the severity of a CPU hardware failure and 
attempts to recover from the interrupt. Abbreviated 
MCAR. 

machine check interrupt. The interrupt that occurs 
if the CPU fails to operate. 

main page pool. The set of all page frames in real 
storage not assigned to the supervisor or one of the 
real partitions. 

main storage. (1) The real address area of virtual 
storage. Contrast with auxiliary storage. (2) All 
program addressable storage from which instructions 
may be executed and from which data can be 
loaded directly into registers. 

microprogram. A set of basic or elementary machine 
instructions that is loaded into control storage to 
control CPU operations. 



transferring records over the multiplexer channel, 
time sharing it on a byte basis. 

multiplexer mode. A means of transferring records 
to or from low-speed I/O devices on the multiplexer 
channel, by interleaving bytes of data. The multi- 
plexer channel sustains simultaneous I/O operations 
on several subchannels. Bytes of data are interleaved 
and then routed to or from the selected I/O devices 
or to and from the desired locations in main storage. 
Multiplex mode is sometimes referred to as byte mode. 

multiprogramming system. A system that controls 
more than one program simultaneously by interleaving 
their execution. 

multitasking. The concurrent execution of one main 
task and one or more subtasks in the same position. 



O 

offline. (1) * Pertaining to equipment or devices 
not under control of the central processing unit. 
(2) Pertaining to program error diagnosis without 
using the computer system (offline program 
debugging). 

* online. (1) Pertaining to equipment or devices under 
control of the central processing unit. (2) Pertaining 
to a user's ability to interact with a computer. 

online test executive program (OLTEP). The control 
program of the online test system. OLTEP is the 
interface between the online test and the operating 
system. 

operand. (1) * That which is operated upon. An 
operand is usually identified by an address part of an 
instruction. (2) Information entered with a command 
name to define the data on which the command 
processor operates and to control the execution of 
the command processor. 

* overflow. (1) That portion of the result of an 
operation that exceeds the capacity of the intended 
unit of storage. (2) Pertaining to the generation of 
overflow as in (1). 



module. A program unit that is discrete and 
identifiable with respect to compiling, combining 
with other units, and loading, for example, the input 
to, or output from, an assembler, compiler, linkage 
editor, or executive routine. 

multiplexer channel. A channel designed to operate 
with a number of I/O devices simultaneously on a 
byte basis. That is, several I/O devices can be 



page. (1) A fixed-length block of instructions, data, 
or both, that can be transferred between real storage 
and external page storage. (2) To transfer instructions, 
data, or both between real storage and external page 
storage. 

page data set. An extent in auxiliary storage, in 
which pages are stored. 
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page fault. A program interruption that occurs when 
a page that is marked "not in real storage" is referred 
to by an active page. Synonymous with page translation 
exception. 

page frame. A 2K block of real storage that can 
contain a page. 

page frame table. In DOS/VS, a table that contains 
an entry for each frame. Each frame table entry 
describes how the frame is being used. 

processor. (1) * In hardware, a data processor. (2) * In 
software, a computer program that includes the com- 
piling, assembling, translating, and related functions 
for a specific programming language. RPG II processor, 
FORTRAN processor. (3) Same as processing program. 

Private Second Level Directory (PSLD). The Private 
Second Level Directory is a table, located in the 
Supervisor and containing the highest phasenames 
found on the corresponding directory tracks of the 
Private Core Image Library. 

page pool. The set of all page frames that may 
contain pages of programs in virtual mode. 

page table (PGT). A table that indicates whether a 
page is in real storage and correlates virtual addresses 
with real storage addresses. 

page translation exception. A program interruption 
that occurs when a virtual address cannot be translated 
by the hardware because the invalid bit in the page 
table entry for that address is set. See also segment 
translation exception, translation specification 
exception. 

paging. The process of transferring pages between 
real storage and the page data set. 

* parameter. A variable that is given a constant value 
for a specific purpose or process. 

physical IOCS. Macro instructions and supervisor 
routines (Channel Scheduler) that schedule and 
supervise the execution of channel programs. 
Physical IOCS controls the actual transfer of records 
between the external storage medium and, real 
storage. 

problem determination aids (PDAID). Programs that 
trace a specified event when it occurs during the 
operation of a program. The traces provided are: 
QTAM Trace, I/O Trace, F/L Trace, and GSVC 
Trace. 

problem program. (1) The user's object program. It 
can be produced by any of the language translators. 
It consists of instructions and data necessary to solve 



the user's problem. (2) A general term for any 
routine that is executed in the data processing 
system's problem state; that is, any routine that 
does not contain privileged operations. (Contrasted 
with Supervisor.) 

processing program. (1) A general term for any 
program that is not a control program. (2) Synonymous 
with problem program. 

program event recording. A System/370 feature that 
enables a program to be alerted to specific events. 
Abbreviated PER. 



Q 



R 



QTAM Trace. A program that records certain 
supervisor and I/O activities on tape or in core-wrap 
mode. 

queue. (1) A waiting line or list formed by items in 
a system waiting for service; for example, tasks to 
be performed or messages to be transmitted in 
message switching system. (2) To arrange in, or 
from, a queue. 



real address. The address of a location in real 
storage. 

real address area. In DOS/VS, the area of virtual 
storage where virtual addresses are equal to real 
addresses. 

real mode. In DOS/VS, the mode of a program that 
may not be paged. 

real storage. The storage of a System/370 computing 
system from which the central processing unit can 
directly obtain instructions and data, and to which it 
can directly return results. Synonymous with processor 
storage. 

real partition. In DOS/VS, a division of the real 
address area of virtual storage that may be allocated 
for programs that are not to be paged, or programs 
that contain pages that are to be fixed. 

recovery management support. The facilities that 
gather information about hardware reliability and 
allow retry of operations that fail because of CPU, 
I/O device, or channel errors. Abbreviated to RMS. 

reenterable. The attribute of a set of code that 
allows the same copy of the set of code to be used 
concurrently by two or more tasks. 

reliability data extractor (RDE). A function that 
provides hardware reliability data that is analyzed by 
IBM. 
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relocatable library. A library of relocatable object 
modules and IOCS modules required by various 
compilers. It allows the user to keep frequently used 
modules available for combination with other 
modules without re compilation. 

resource. Any facility of the computing system or 
operating system required by a job or task, and 
including main storage, input/output devices, the 
central processing unit, data files, and control and 
processing programs. 

routine. An ordered set of instructions that may have 
some general or frequent use. 



Second Level Directory (SLD). The table, located 
in the Supervisor and containing the highest phase- 
names found on the corresponding directory tracks 
of the system core image. 

segment. A continuous 64K area of virtual storage, 
which is allocated to a job or system task. 

segment table (SGT). A table used in dynamic 
address translation to control user access to virtual 
storage segments. Each entry indicates the length, 
location, and availability of a corresponding page 
table. 

segment translation exception. A program interruption 
that occurs when a virtual address cannot be translated 
by the hardware because the invalid bit in the segment 
table entry for that address is set. See also page 
translation exception, translation specification 
exception. 

self-relocating. A programmed routine that is loaded 
at any doubleword boundary and can adjust its 
address values so as to be executed at that location. 

self-relocating program. A program that is able to 
run in any area of storage by having an initialization 
routine to modify all address constants at object time. 

selector channel. A channel designed to operate with 
only one I/O device at a time. Once the I/O device is 
selected, a complete record is transferred one byte at 
a time. 

SEREP. A stand-alone environment recording, 
editing, and printing program that makes the data 
contained in an error logout area of real storage 
available for further analysis. 

Shared Virtual Area (SVA): The last part of the 
virtual system address space that contains phases 
which are reenterable and relocatable and which can 
be shared between partitions. 



soft stop. A condition in which the CPU has stopped 
processing but continues to handle any requested 
interruptions. 

stand-alone dump. A program that displays the 
contents of the registers and all of real storage and that 
runs independently and is not controlled by DOS/VS. 

subtask. A task in which control is initiated by a 
main task by means of a macro instruction that 
attaches it. 

storage protection. An arrangement for preventing 
access to storage for either reading, or writing, or 
both. 

system generation. The process of tailoring the IBM 
supplied operating system to user requirements. 

system debugging aids. A set of routines provided 
to trace specific program events by using the program 
event recording facilities. Abbreviated SDAIDS. 

System Directory List (SDL). A list of highly used 
phases (either only in the system CIL or also in the 
SVA). This list is placed in the SVA. 

system recorder file. The data file that is used to 
record hardware reliability data. 



task. A unit of work for the central processing unit 
from the standpoint of the control program. 

task selection. The supervisor mechanism for 
determining which program should gain control of 
CPU processing. 

teleprocessing. The processing of data that is received 
from or sent to remote locations by way of telecom- 
munication lines. 

terminal. (1) * A point in a system or communication 
network at which data can either enter or leave. (2) Any 
device capable of sending and receiving information 
over a communication channel. 

Terminating partition. This is a partition owning a 
program which is in the process of being terminated 
either because of a program cancel condition or 
because of EOJ. 

trace. (1) To record a series of events as they occur. 
(2) The record of a series of events. 

* tracing routine. A routine that provides a historical 
record of specified events in the execution of a program. 
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track hold. A function for protecting DASD tracks 
that are currently being processed. When track hold is 
specified in the DTF, a track that is being modified by 
a task in one partition cannot be concurrently accessed 
by a task or subtask in another partition. 

transient area. An area in the supervisor used for 
temporary storage of transient routines, such as non- 
resident supervisor call or error-handling routines. 

transient routines. These self-relocating routines are 
permanently stored on the system residence device 
and loaded (by the supervisor) into the transient area 
when needed for execution. 

translation specification exception. A program inter- 
ruption that occurs when a page table entry, segment 
table entry, or the control register pointing to the 
segment table contains information in an invalid 
format. See also page translation exception, segment 
translation exception. 



U 



user program, see problem program. 

unrecoverable error, see irrecoverable error. 

utility program. A program designed to perform a 
routine task, such as transcribing data from one 
storage device to another. 



V 



virtual address. An address that refers to virtual 
storage and must, therefore, be translated into a real 
storage address when it is used. 



virtual address area. In DOS/VS, the area of virtual 
storage whose addresses are greater than the highest 
address of the real address area. 

virtual mode. In DOS/VS, the mode of a program 
which may be paged. 

virtual storage. Addressable space that appears to the 
user as real storage, from which instructions and data 
are mapped into real storage locations. The size of 
virtual storage is limited by the addressing scheme of 
the computing system and by the amount of auxiliary 
storage available, rather than by the actual number 
of real storage locations. 

virtual storage access method (VSAM). VSAM is an 

access method for direct or sequential processing of 
fixed and variable length records on direct access 
devices. The records in a VSAM file can be organized 
either in logical sequence by a key field (key sequence) 
or in the physical sequence in which they are written 
on the file (entry-sequence). A key sequenced file has 
an index, an entry-sequenced file does not. 

volume. (1) That portion of a single unit of storage 
media which is accessible to a single read/write mechanism, 
for example, a drum, a disk pack, or part of a disk 
storage module. (2) A recording medium that is 
mounted and dismounted as a unit, for example, a reel 
of magnetic tape, a disk pack, a data cell. 

VSAM access method services. A multifunction utility 
program that defines VSAM files and allocates space 
for them, converts indexed sequential files to key- 
sequenced files with indexes, facilitates data portability 
between operating systems, creates backup copies of 
files and indexes, helps make inaccessible files accessible, 
and lists file and catalog entries. 
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AB option table 4.102 

ABSAVEarea 4.108 

ACB, contents of 4.76 

ACB macro 4.76 

Address trap, see stop on address 

see also data compare trap 
Address translation, see channel program translation 

see also converting address 
ALTER command 2.6 
example of output 2.6 
format of 2.6 
restrictions of use 2.7 
when to use 2.7 
ALTER/DISPLAY console operation all Models 2.1 31 
error indications Models 115/125 2.142, 2.143 
error messages, Models 135/145/155-H 2.132 
examples of display, Model 1 15/125 2.142, 2.143 
examples of displays, Model 158 2.144 
examples of output, Models 135/145/155-H 2.136 
how to use, operators flowchart 
Models 135/145/155-11 2.135 
Models 115/125 2.141 
Model 158 2.144 
options 

Models 135/145/155-11 2.134 
Models 115/125 2.140 
when to use 2.132 
Altering SDAID parameters (after SDAID initialization) 2.87 
Altering storage locations 

using the ALTER command 2.6 
using the ALTER/DISPLAY console operation 2.1 32 
Altering the contents of 
control registers 

Models 135/145/155-11 2.135 
Models 115/125 2.141 
Model 158 2.144 
general purpose registers 

Models 135/145/155-11 2.135 
Models 115/125 2.141 
Model 158 2.144 
virtual storage locations 

using the ALTER command 2.6 
using the ALTER/DISPLAY console operation 2.1 32 
Alternate area, for PDAID core-wrap output 2.41 
dumping 2.60 

example of, in a stand-alone dump output A. 16 
locating 2.60 
specifying 2.60 
Analyzing information (general) 1.28 
Analyzing information obtained from 
DSERV program 2.114 
EREP, example of 2.114 
Library display programs 2.115 
Linkage editor diagnostic of input 2.182 

examples of error indications 2.182, 2.1 83 
Linkage editor map 2. 1 3, 2. 1 66 
LSERV program 2.110 
LVTOC program 2. 1 21 , 2. 1 22 
Map command 2.169 
PDAID trace routines 2.39 
SDAID trace routines 2.74 
Stand-alone dump, example of 
System dump, example of 2. 1 3 
SYS VIS dump 2.130 

see also flowcharts (for the programmer) 4.1 
Areas destroyed by the stand-alone dump program 
example of, (in a stand-alone dump output) A.l 1 
see also non-critical area 
Assembler language macros 
Declarative macros 

forLIOCS 4.65,4.67 
forVSAM 4.72 



Assembler language macros (continued) 
Imperative macros 

forLIOCS 4.65 

forVSAM 4.72,4.73 
Module generation macros 4.68 
Supervisor communication macros 2.32 
VSAM file description macros 4.72 

SHOWCB macro, using 4.73 

TESTCB macro, using 4.73 



B 



BIM simulator A.37 

Boundary box 4.115 

example of (in a dump output) A. 14, A. 25 

explanation of the contents of 4.1 15 
how to locate 4.115 

BTAM interface module simulator A.37 



Cancel codes and messages 4.94 

causes of code X'21 \ 4.24 

list of 4.94,4.95 

use of, and location 4.94 
Cancelling the SDAID non-destroying dump 2.84 
CANCELV command 2.120 

example of 2.121 
Cathode ray tube, Model 115 and 125, example of 1.25 

see also Model 1 15 and 125 displays 

see also Model 158 displays 
CCB macro, example of 4.64 
CCW assembler instruction, example of 4.64 
CCW copy block 4.126 

example of, in a dump output A. 15 

format and contents of 4.126 
CCW/Translation control block 4. 1 27 
Changing real address to virtual 4.1 18 

using the ALTER command 2.6 

using the ALTER/DISPLAY console operation 2.1 32 
Changing the contents of control registers 

Model 135/145/155-11 2.135 

Model 115/125 2.141 

Model 158 2.144 
Changing the contents of general registers 

Models 135/145/155-H 2.135 

Models 115/125 2.141 

Model 158 2.144 
Changing virtual addresses to real 4.116 
Channel Address Word (CAW) 2.171 

format and contents 2. 1 7 1 

how to locate 2.175 
Channel bucket 4.58 

examination of 4.58 

explanation of the contents of 4.59 

how to locate 4.58 
Channel Check Handler (CCH) 2. 197 
Channel Command Word (CCW) 4.83 

format and contents 4.83 

how to locate 4.83 

see also channel program 
Channel control table 4.58 

explanation of the contents of 4.59 

how to locate 4.5 8 
Channel Status Word (CSW) 2.172 

format and contents 2.172 

how to locate 2.175 
Channel Queue (CHANQ) 4.56 

examination of 4.56 

explanation of the contents of 4.57 

format of 4.57 

how to locate 4.56 
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C (continued) 

Channel program 4.82 

how to locate 4.83 
Channel program translation 4.120-4.128 
Clear, option of EREP 2.210 
Clear real storage, console operation 2.163 
Codes, list of, table of 

Cancel codes 4.94, 4.95 

causes of message 0S04I, list of 4.24 

control statements for DUMPGEN 

for DTF types 4.67 

for I/O device types 4.50-4.52 

for IPL reason information 2.204 

operands for the DUMP command 2.1 

options for ALTER /DISPLAY console operation 
Models 135/145/155-11 2.134 
Models 115/125 2.140 
Model 158 2.144 

options for DUMPGEN 2.16 

options for EREP 2.209 

options for LISTIO command/statement 2.168 

parameters for initializing PDAID 2.62 

parameters for the MODE command 2.205, 2.206 

parameters for initializing SDAID 2.88 

parameters for the SELECT option of EREP 2.212 

parameters for initializing the transient dump 2.28 

program check interrupt codes, list of 4.109 

SDAID output classes, table of 2.79, 2.280 

type of debugging aids, reference list 2.3 

wait state message codes 2.176, 3.3, 3.4, 4.6 
Combined recording 2.201,2.215 
Commands 

ALTER 2.6 

CANCELV 2.120,2.121 

DSPLY 2.8 

DSPLYV 2.120,2.122 

DUMP 2.10 

LISTIO 2.166,2.167,2.168 

LOG 2.168 

MAP 2.169 

MODE 2.205 

NOLOG 2.168 

ROD 2.203 
Computer output, see examples 
Command Control Block (CCB) 4.71-4.81 

examination of 4.77 

example of in a dump output 4.78, A.15 

format and contents 4.79-4.81 

how to locate 4.77 
Communication regions 4.34-4.43 

example of, in a dump output A. 1 3 

for each partition 4.34 

locating, example of 4.34 
COMRG macro 4.34 
Console dump operation (Model 1 15/125) 2.134 

operators flowchart 2.135 
Contents of, see explanation of the contents of 
Control of input and output, see IOCS 
Control registers 

allocation A.6 

altering the contents of and displaying 
Models 135/145/155-11 2.135 
Models 115/125 2.141 
Model 158 2.145 

dumping, see dumps 
Conventional dump, (Translating dump), example of A.l 1-A.30 
Converting Addresses 

real to virtual 4.118 

virtual to real 4.116 
Copying the Page Set (PDS) 2.126 
Core-wrap output, for PDAID 2.41 
CPU ID 

example of, in SDAID output 2.95 

example of, in stand-alone dump A. 12 



INDEX 



Current PSW 

dumping, displaying 

Models 135/145/155-11 2.135 
Models 115/125 2.140,2.141 
Model 158 2.145 

format and contents 2.173 



D 



Data compare trap 

Model 145 2.155 

Model 158 2.158 
Debuggers flowcharts, see flowcharts 
Debugging 1.4 

aids for, reference list of 2.3 

definition 1 .4 

pictorial representation of 1.2,1.5 
Debugging aid output, see examples 
Debugging hints 

for initializing SDAID 2.87 

forVSAM 4.72,4.73 

to analyze the stand-alone dump output 2.22, AU-A30 

to locate the CCB 4.78 
Declarative macro 4.65 
De-editing service program (ESERV) 2.116 
Define the file (DTF) macro 4.65 

contents of a DTFMT 4.66 

example of a DTFMT 4.70 
Description of 

BIM simulator A. 37 

Cancel codes 4.94 

Channel program 4.82 

Channel program translation 4.1 20 

Command Control Block (CCB) 4.76 

Control registers A.6 

Debugging 1 .4 

DUMPGEN program 2.15 

EREP 1.23,2.207 

ESTVUT 2.219 

EVA 2.202 

General registers, uses of 4.96 

Hard wait 1.10 

Indicators, for wait /loop 1.12 

Incorrect out put 1.13 

I/O device malfunctions 1.16 

Input/output control system 4.62 

Intermittent errors 1.14 

Job accounting interface A.31-A.34 

Label information cylinder display program (LSERV) 2.102 

Logical IOCS 4.62 

Loop tracing 1.20 

Low address storage 1.18, 2.171 

Machine Check Interrupt (MCI) 2.196 
illustration of 2.191 
Soft MCI 2.192 
Hard MCI 2.192 

MAP command 2.169 

Models 115/125 maintenance log analysis 1.25, 2.230 

Model 158 display frames 1.26,2.2 

OLTEP 2.234 

Page management 4.112 

PDAID trace routines 2.39 

Physical IOCS 4.62 

Program check interrupt (PGMCHK) 1.15 

Program Interrupt Key (PIK) A. 3 

Recovery Management Support (RMS) 1.21, 2.188 
illustration of 1.22,2.189 

Save areas 4.106 

SDAID dump facilities 2.75 

SDAID trace routines 2.74 

SEREP 1.24,2.226 

Soft wait 1.10 

Standalone dump program 2.18 
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Description of (continued) 

Storage dumps 1.19,2.5-2.35 
Supervisor calls (SVCs) 4.84 
Supervisor I/O tables and information blocks 4.44 
SYSLOGID A.3 
System Dump 2.12 
System malfunctions 1.6 
SYS VIS dump program 2.15 
Tables used by the page manager 4.112 
Transient dump program 2.25 
Unintended program loop 1.8 

Volume table of contents display program (LVTOC) 2.1 1 1 
Wait state 1.10 
Wait state messages 2.176 
Details of contents for 

Partition communication regions 4.35-4.41 
System communication region 4.42, 4.43 
Device type codes 4.50-4.52 

Discontinuing the SDAID non-destroying dump 2.84 
Display command, see DSPLY command 
Display frame (Model 158) 
Display operators Console (DOC) 1 .25 

see also Models 1 15/125 display, examples of 
see also Model 158 frames, examples of 
Displaying libraries, SSERV, RSERV, CSERV, PSERV 2.111 
Displaying library directories, DSERV 2.1 1 1 
Displaying the contents of 

any partition, see DUMP command 
control registers 

Models 135/145/155-11 2.135 

Models 115/125 2.141 

Model 158 2.145 
Label information cylinder, see LSERV 
Libraries 2.111 
Logout areas, see SEREP 

see also maintenance program selection and log analysis 
Low address storage, see SDAID output classes (LOCORE) 

see also dumps 
Page management tables 

see SDAID output (PAGET AB) 2.79 
Partition 

see DUMP command 

see also DUMP and JUMP macro 

see also system dump or // OPTION DUMP 
Real storage, see ALTER/DISPLAY console operation 

see also SDAID output (DUMPREAL) 

see also stand-alone dump 
Small areas of real and virtual storage 

see DSPLY command 

see also Snap Shot dump 
Supervisor, see SDAID output (SUPVISOR) 

see also DUMP command 
SYSREC, see EREP 

SYS VIS (Page Data Set), see SYSVIS dump 
Virtual storage, see ALTER/DISPLAY console operation 

see also dumps 
Virtual storage locations 

see ALTER/DISPLAY console operation 

see also dumps 
Volume table of contents, see LVTOC 

see also CANCELV command 

see also DSPLYV command 
VSAM control blocks 4.74 
DSPLY command 2.8 
example of output 2.8 
format of 2.8 
restrictions of use 2.9 
when to use 2.9 
DSPLYV command 2.120 

examples of output 2.121 
DTF type codes, list of 4.67 
DTFMT 

contents of 4.66 



DTFMT (continued) 

example of in a dump output 4.70 
in an assembly listing 4.70 
Dump Analysis 

Stand-alone dump output A.l 1-A.30 
System dump output 2.13,2.14 
Transient dump output 2.31 
DUMP command 2.10 
examples of output 2.1 1 
format of 2.10 
operands 2.10 
when to use 2.11 
DUMP macro 2.34 

consideration of use 2.35 
format of 2.34 
information dumped 2.34 
when to use 2.35 
DUMPGEN 2.15 

control statement 2.17 
executing 2.15 
job stream example 2.17 
messages 2.17 
operands 2.16 
DUMPGEN and stand-alone dump 2.15 
DUMPS 

DSPLY command 2.8 

DUMP command 2.10 

DUMP macro 2.34 

Dumping the copy of SYSVIS to SYSLST 2.127 

Dumping a partition 

using the DUMP command 2.10 

using the DUMP macro 2.34 

using the JDUMP macro 2.34 
Dumping communication regions 

SDAID output class 4 (COMREG) 2.79, 2.98 
Dumping low address storage 

SDAID output class 3 (LOCORE) 2.79, 2.97 
Dumping page management tables 

SDAID output class 5 (PAGETAB) 2.79, 2.97 
Dumping real storage 

SDAID output class 7 (DUMPREAL) 2.79 
Dumping SYSREC, see EREP 
Dumping SYSVIS (PDS) to tape or disk 2.126 
Dumping the alternate area 2.53, 2.60 
Dumping the logout areas, see SEREP 
Dumping the PD area 2.44, 2.56 
Dumping the supervisor 

SDAID output class 6 (SUPVISOR) 2.79 

see also DUMP command 
Dumping the SVA, see system dump 
Formatting dump 2.19 

example of A.18-A.30 
JDUMP macro 2.34 
Printing the contents of SYSVIS 2.128 
Printing the system recorder file, see EREP 
Printing the tape used for PDAID output (PDLIST) 2.41 
SDAID dump routines 2.75 

Dump on program check 2.85 

Non-destroying dump 2.84 

Stop and dump routines 2.83 
Snap shot dump 

PDUMP macro 2.32 

SDAID PDUMP, SDAID output class 8 (PDUMP) 2.83 
Stand-alone dump 2.18 

example of A.11-A.30 

pictorial representation of 1.19 
Stop on event and dump selected SDAID output 2.83 
System dump 2.12 
SYSVIS dump 2.125 
Translating dump, example of 2.1 3, 2.14 
Transient dump 2.25 
ZDUMP A.37 
Dumps controlled by JCS 2. 1 2 



D (continued) 

Dumps controlled by JCS (continued) 

// OPTION DUMP (system dump) 2.12 
Dumps invoked by operator command 2.6 

DSPLY (display) command 2.8 

DUMP command 2.10 
Dump on program check (SDAID) 2.85 

when to use 2.85 

see also // OPTION DUMP (system dump) 
Dynamic dump 

PDUMP macro 2.32 

SDAID PDUMP 2.78 
Dynamic reallocation of partition or page pool (DRAP) 2.196 



EDIT, option of EREP 2.210 
Editing, the source statement library 

using ESERV 2.116 

using SSERV 2.111 
Editor, linkage 2.181 
Environmental Recording, Editing, and Printing 1.23, 2.207 

description of options 2.210-2.215 

entering options 2.222 
through SYSIPT 2.223 
through SYSLOG 2.222 

example job stream 2.220, 2.223 

example of output 2.224 

executing 2.220 

history tapes 2.222 

list of options 2.209 

logical units required 2.208 

operators flowchart, for executing 2.221 

relationship between EREP and SYSREC, illustration 2. 1 94 

relationship between EREP and RMS; illustration 2.1 89 

system requirements 2.207 

when to use 2.225 
EREP history tapes 2.216 
EREP options 

description of 2.210-2.215 

list of 2.208,2.209 
Error Checking and Correction (ECC) 2.196 

Modes of 2.197 
Error detection with VSAM macros 4.73 
Error during IPL (flowchart) 3.3 
Error Frequency Limits (EFL) 2.196 

Threshold values 2.196 
Error Queue (ERRQ) 4.60 

examination of 4.60 

format and contents 4.61 

how to locate 4.60 
Error Recovery Procedures (ERP) 2.198 

illustration of system action 2.193 
Error recovery block 4.60 

format and contents 4.61 

how to locate 4.60 
Error Volume Analysis (EVA) 2.202 

description and operation 2.202 

how and when to use 2.202 

system requirements 2.202 
ESERV 2.116 

errors during update 2. 1 16 

how to use 2.116 

input to and output from 2.1 17 

lob stream example A.7 
ESTVUT 2.219 

contents and format output 2.219 

job stream example 2.219 
Examples 

computer output 

ALTER command 2.6 

ALTER/DISPLAY console operation 2. 1 36 

assembler listing showing PIOCS macros 4.64 
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Examples (continued) 

assembler listing showing the expansions of a DTFMT 4.70 

CANCELV 2.121 

DSERV 2.114 

DSPLY command 2.8 

DSPLYV command 2.122 

DUMP command 2.11 

EREP output 2.114 

Linkage editor ma p 2.181 

Locating the active communication region 4.35 

Low address storage 2.175 

LSERV 2.108,2.109,2.110 

LVTOC 2.121 

Job stream trace 2.167 

MAP command 2.169 

PD AID F/L trace 2.47 

PDAID GSVC trace 2.50 

PDAID trace 2.44 

PDAID QT AM trace 2.53 

PDUMP macro 2.33 

RSERV 2.115 

SDAID dump showing how to locate the page 
management tables 4.120 

SDAID initializing output 2.95 

SDAID job entry 2.96 

SDAID output class COMREG 2.98 

SDAID output class FASTREC, AUTOMATIC 2.99 

SDAID output class PAGET AB 2.97 

SDAID BR, IF, GA trace output class PSW 2.100 

SDAID page tracing routine output 2.99 

Stand-alone dump A.11-A.30 

System dump showing isolation of a program check, 
data exception 2.13,2.14 

System dump showing the partition save area 4.106 

System dump showing the CCB 4.78 

System dump showing a DTFMT 4.70 

System status information 2.169 

Transient dump 2.4 
see also job stream examples 
see also Models 1 15/125 display, examples of 
see also Model 158 frames, examples of 

EXCP macro, example of 4.64 
Executing EREP 2.220 

entering options 2.220 
through SYSIPT 2.223 
through SYSLOG 2.222 

table of options 2.209 

operators flowchart 2.221 
Expansion flags for SYSCOM 4.43 
Explanation of SDAID initializing output 2.95 
Explanation of the contents of the AB option table 4.102 
Explanation of the contents of 

AB option table 4.102 

ACB 4.76 

Boundary box 4.115 

CCB copy block 4.124 

CCW copy block 4.126 

CCWrTCB 4.127 

Channel Address Word (CAW) 2.171 

Channel Bucket 4.59 

Channel control table 4.59 

Channel control Word (CCW) 4.83 

Channel control table 4.59 

Channel queue 4.57 

Command Control Block (CCB) 4.79-4.81 

Control blocks used by POWER A.39-A.47 

Control blocks used by POWER RJE A.49-A.64 

DTFMT 4.66 

Error block 4.61 

Error recovery 4.61 

Error queue 4.61 
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Explanation of the contents of (continued) 
EXLST 4.74 
FICL 4.46 
FLPTR 4.56 
FOCL 4.48 

Interrupt status information 4.109 
IT option request table 4.101 
IT option table 4.100 
Job Information Block (JIB) 4.55 
Label save area 4.108 
Line mode table A. 10 
Low address storage 2.174, 2.175 
LUB 4.47 
NICL 4.46 
OC option table 4.105 
Page Frame Table 4.114 
Page table 4.113 

Partition communication regions 4.35-4.41 
Par titio n save area 4.108 
PC option table 4.104 
PDarea 2.56,2.57 
PHO option table 4.103 
Program Information Block (PIB) 4.89-4.91 
PIB2 4.93 

Program Status Word (PSW) 2.173 
Programmer Unit Block (PUB) 4.48, 4.49 

PUBOWNERSHIP 4.53 
RPL 4.75 
SDarea 2.85 
Segment table 4.113 
System save areas 4.110 
System communication region 4.42, 4.43 
Supervisor transient area 2.195 



FASTREC output, see SDAID output classes 
FAVP 4.54 

how to locate 4.54 
First On Channel List (FOCL) 4.48 

how to locate 4.48 
First In Class List (FICL) 4.46 

how to locate 4.46 
Fix information block 4.128 
Flags for SYSCOM 4.43 
Flowcharts, for the operator 

Action, in event of system malfunction 

during IPL 3.5 

job canceled by system 3.27 

recognized as a wait state 3.16 

recognized as an unintended loop 3.20 

recognized as incorrect output 3.26 
Initial system checks 3.15 
Stop on address compare 2.143 

Models 135/145/155-11 2.144 

Models 115/125 2.146 

Model 158 2.159 
To copy SYSVIS (PDS) to disk 2.24 
To copy SYSVIS (PDS) to tape 2.24 
To dump real storage (Models 115/125 only) 2. 
To execute EREP 2.221 
To execute SEREP 2.227 
To execute the stand-alone dump 2.23 
To initialize PD AID 2.63 
To initialize SDAID 2.89 
To initialize the transient dump 2.29 
To trace a loop by instruction stepping 

Models 135/145/155-11 2.147 

Models 115/125 2.142 

Model 158 2.151 
To use the ALTER/DISPLAY console feature 

Models 135/145/155-11 2.135 

Models 115/125 2.141 



Flowcharts for the operator (continued) 

Model 158 2.145 
Flowcharts, for the programmer 

Error generate during IPL 4.5 

Hard wait with message in low address storage 4.7 

Hard wait with no message in low address storage 4.8 

Incorrect output 4.12,4.13 

Initial checks 4.3 

Job canceled by ILLEGAL SVC 4.25 

Job canceled for other reasons 4.26 

Program check in POWER/POWER RJE 4.30 

Program check in supervisor 4.27 

Program check in user program 4.19 

Soft wait 4.9 

Unintended loop 4.11 
FLPTR 4.56 

how to locate 4.56 
F/L trace 2.45 

examples of output 2.47 

format and contents of a trace entry 2.45 

tracing options 2.46 

when to use 2.46 
Format of SYSRES 2.104 
Formatting dump 2.19 

example of A.11-A.30 

generating, see DUMPGEN 
Free List Pointer (FLPTR) 

how to locate 
Further error isolation 1.27 



G 

Gathering information 1.17,4.2 

Hardware error recording and recovery 1 .22, 2. 

EREP 1.23,2.210 

Log analysis displays 1.25, 2.230 

Maintenance program selection 1.25,2.230 

Recovery Management Support (RMS) 1 .21 , 2.1 88 

SEREP 1.24,2.226 
Linkage editor 2.181 
Loop tracing 1.20 

see trace routines 

see also tracing loop 
Low address storage 1.18, 2.171 
Operator flowcharts 

on occurrence a program check interrupt 3.27 

when system in loop 3.20 

when system in wait state 3.16 

when system procedures obviously incorrect output 
Storage dumps 1.19 

see also dumps 

see also serviceability aids from the operator console 
General purpose registers 

Altering the contents of and displaying 

Models 135/145/155-11 2.135 

Models 115/125 2.141 

Model 158 2.145 
Dumping, SDAID output class 2 (GRP) 2.79 

see also dumps 
Displaying 

see ALTER/DISPLAY console operation 

see also dumps 
Usage 4.96 

by DOS/VS 4.96 

by job accounting 4.97 

by POWER 4.97 

byPOWER/RJE 4.97 

for programmer use 4.96, 4.98 

for sub-routine linkage 4.96 
General register alter trace 2.82 

when to use 2.82 
Generating a stand-alone dump program 2.15 
Generation option table A. 50 



3.26 
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G (continued) 

GSVC trace 2.48 

examples of output 2.50 
format and contents of a trace entry 
tracing options 2.47 
when to use 2.47 



INDEX 



2.48 



H 

Hand s-on debugging 1 . 4 

see also flowcharts, for the operator 
Hard wait 1.10 
causes 1.11 
during IPL 2.177 

isolation of cause (programmers flowchart) 4.7, 4.8 
messages, list of 2.161, 3.2, 4.6 
operators flowchart 3.14 
Hardware error recording and recovery 1.21, 2.188 

pictorial representation of 1.22, 2.188 
Hardware Instruction Retry (HIR) 2.197 

Hints for debugging, see debugging hints 
HIST, option of EREP 2.214 
History tapes 2.216 
creating 2.216 
for EREP 2.216 
HISTORY/RDE 2.216 
TES (Tape error statistics) 2:216 
How to copy SYSVIS (the page data set) on disk or tape 2.126 

see also SYSVIS dump 
How to locate 

AB option table 4.102 
Boundary box 4.115 

example of A. 14 
CCB 4.78 

example of 4.78 
CCB copy block, example of A.15, A. 23 
CCW copy block, example of A.15, A.23 
CCW/Translation control block 4.127 TCS 
Channel bucket 4.58 

example of A. 14 
Channel control table 4.58 
Channel program (CCW) 4.81 

example of 4.78 
CHANQ 4.56 

example of A. 14 
Control blocks used by POWER A.38-A.47 
Control blocks used by POWER RJE A.48-A.64 
CPU 10, example of 2.95, A.12 
Error recovery block, error block 4.60 

example of A. 14 
ERRQ 4.60 

example of A. 14 
FAVP 4.54 

example of A. 1 3 
FICL 4.56 

example of A. 13 
FLPTR 4.56 

example of A.12 
FOCL 4.48 

example of A. 13 
Idal block, example of A.15 

example of A.15 
IT option request table 4.101 
IT option table 4.100 
JIB 4.54 

example of A. 13 
Job accounting interface common table A. 3 3 
Job accounting interface partition table A. 3 2 
Label save area, illustration of 4.107 
LUB 4.56 

example of A. 13 
NICL 4.54 

example of A. 13 
OC option table 4.105 



How to locate (continued) 
Page frame table 4.114 

example of 4.119, A.15 
Page table 4.113 

example of 4.119, A.15 
Partition communication regions * 4 - :54 ~" ' H , 3^1 

example of 4.34, A. 13 
Partition save area 4.106 

example of 4.106 
PC option table 4.104 
PDarea 2.56 

example of 2.44, A. 14 
PD standard preface table A. 14 

example of A. 14 
PHO option table 4.103 
PIB 4.88 

example of A. 13 
PIB2 4.92 

example of 4.34, A. 13 
PUB 4.47 

example of A. 13 
PUBOWNER 4.53 
SDarea 2.80 
Segment table 4.112 

example of 4.119, A.15 
System communication region (SYSCOM) 4.42 

example of 2.160, A.12 
System save areas 4.110 
How to use 

ALTER command 2.6 
ALTER/DISPLAY console operation 

Models 135/145/155-11 2.128 

Models 115/125 2.134 

Model 158 2.145 
DSPLY command 2.8 
DUMP command 2.10 
DUMP macro 2.34,2.35 
EREP 2.192-2.210 
ESERV 2.116 
ESTVUT 2.204 
EVA 2.187 
Control registers, see program event recording 

function of A. 6 

see also SDAID parameters changes 
Instruction step 

Models 135/145/155-11 2.139 

Models 115/125 2.141 

Model 158 2.151 
IPL reason information 2.189 
JDUMP macro 2.34,2.35 
LIOCS 4.65 

MAP command 2.151,2.154 
Models 1 15/125 dump operation 2.147 
Models 115/125 maintenance log analysis 
Model 158 display frame 2.232 
Option dump, see also system dump 2.12 
Output from the 

DSERV program 2.114 

Library display programs 2.115 

LSERV program 2.102,2.210 

LVTOC program 2.121 

SYSVIS dump program 2.157 

PDAID 2.58,2.62,2.63 

PDAID output, see examples 

PDUMP macro 2.33 

PIK A.3 
PIOCS 4.64 

example of 4.64 
Relocation factor, example of using 2.1 3, 2.100 
ROD command 2.188 
SDAID 2.86,2.88,2.89 
SDAID output, see examples 
Section 2 of this manual 2.2 



\ 
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INDEX H (continued) 

How to use (continued) 

Section 3 of this manual 3.1 
Section 4 of this manual 4.1 
SEREP 2.227 

Models 135/145/155-H 2.226 

Model 158 2.228 
Serviceability aids for POWER/POWER RJE A.35-A.37 
SHOWCB macro 4.73 
Stop on address compare 2.143 

Models 135/145/155-11 2.143 

Models 115/125 2.154 

Model 158 2.159 
SYSLOGID A.3 
System dump 2.13,2.14 
TESTCB macro 4.73 
The linkage editor map 2.13,2.166 
The stand-alone dump output 2.22, A.l 1 
TheTIK A.4 
This manual vii 
Transient dump program 2.25, 2.26 

I 

IDAL block 4.122 
Imperative macros 

forLIOCS 4.65 

forVSAM 4.72,4.73 
Index, visual, of debugging aids 2.3 
Index frame (Model 158) 1.26,2.228 
Incorrect output 

causes 1.13 

definition 1.13 

isolation of cause, programmers flowchart 4.12 

operator action 1.13 

operator flowchart 3 .26 

recognizing 1.13 
Indicators for loops and wait states 1.12 
Individual recording 2.201 , 2.205 
Information blocks, see supervisor information blocks 
Information recorded on SYSREC, see SYSREC record types 
Initializing output (SDAID) 2.95 
Initializing SDAID flowchart 2.89 
Initial checks for the programmer 4.3 
Initial examination of 

job control language and device assignments 3.15 

job set up, job preparation 3.13 

program preparation 4.3 

stand-alone dump output 2.22 
example of A.11-A.30 
Initial system checks for the operator 3.15 
Instruction stepping, see tracing a loop 

see also SDAID instruction trace 
I/O error during FETCH 2.180 
I/O device malfunctions 1.16 

examples of 1.16 

operator action 1.16 
I/O device type codes 4.50-4.52 
Input/output system, see IOCS 
Instruction trace 2.82 

when to use 2.82 
Intermittent errors 1.14 

definition 1.14 

hardware failures 1.14 

programming errors 1.14 

recording, see RMS 
Interrelationships between 

imperative, declarative and MOD macros 4.69, 4.70 

LIOCS and PIOCS, illustration of 4.63 

original channel program and the copy blocks 4.123 

page management tables, illustration of 4. 1 1 7 

supervisor I/O tables and blocks 4.45 

VSAM control blocks, illustration of 4.74 
Interrupt status information 4.109 



Interpreting output from 

a dump containing a CCB 4.78 

a stand-alone dump A.11-A.30 

a system dump 2.14,2.14 

DSERV 2.114 

EREP 2.224 

LSERV 2.110 

LVTOC 2.121, 2.122 

PDAID 2.44,2.47,2.50,2.53 

SDAID 2.95,2.100 

The Linkage Editor Map 2.13 

The Linkage Editor diagnostic of input 2.1 82, 2.1 83 

The MAP command 2.169 

Transient dump 2.31 
IOCS (input/output control system) 4.62-4.76 

see also Logical IOCS 

see also Physical IOCS 

see also Virtual Storage Access Method (VSAM) 
I/O tables 

Access Method Control Block (ACB) 4.76 

CCB copy block 4.122 

CCW copy block 4.126 

CCW Translation Control Block 4. 1 27 

Channel bucket 4.58 

Channel control table 4.58 

Channel queue (CHANQ) 4.56 

Error recovery block 4.60 

Error Queue (ERRQ) 4.60 

Exit List Block (EXLST) 4.74 

Idal block 4.122 

Job Information Block (JIB) 4.54 

Line Mode Table (MT) A.10 

Logical Unit Block (LUB) 4.46 

Physical Unit Block (PUB) 4.48 

PUBOWNERSHIP 4.53 

Request Parameter List (RPL) 4.75 
I/O Requestors Partition or System Task ID (REQID) A.5 
I/O Requestors Task Identification (TKREQID) A.5 
I/O Trace 2.42 

examples of output 2.44 

format and contents of a trace entry 2.42 

tracing options 2.43 

when to use 2.43 
IPL/EOD recording 2.203 
IPL error messages 2.177 
IPL errors 2.177 

operators action (flowchart) 3.3 

programmer action (flowchart) 4.5 
IPL reason information codes 2.204 
Isolating errors recognized as 

a hard wait state 4.7,4.8 

a loop 4.11 

a program check in POWER/POWER RJE 4.30 

a program check in supervisor 4.25 

a program check in SVA 4.23 

a program check in user program 4.19 

a soft wait state 4.9, 4.10 

an error during IPL 4.5 

illegal SVC 4.25 

incorrect output 4.12-4.17 

other reasons 4.26 
IT option request table 4.101 
IT option table 4.100 
Interrelationship between DTF and MOD macros 4.69 



JDUMP macro 2.34 
format of 2.34 
information dumped 2.34 
when to use 2.35 
accounting interface A.stet 
common table A. 33 
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J (continued) 

JDUMP macro (continued) 

general description A. 31 

partition table A. 32 

programming consideration A. 3 4 
Job control commands and statements 

see commands 

see also statements 
Job Information Block (JIB) 4.54 

examination of 4.54 

explanation of the contents of 4.55 

format of 4.55 

how to locate 4.54 
Job stream examples 

copying SYSVIS to SYS001 2.126 

dumping SYS001 (SYSVIS copy) to SYSLST 2.127 

dumping SYSVIS to SYSLST 2.128 

executing CSERV 2.112 

executing DSERV 2.113 

executing DUMPGEN 2.17 

executing EREP 2.110,2.113 

executing ESTVUT 2.209 

executing ESERV A.8 

executing LSERV 2.102 

executing LVTOC 2.120 

executing PDAID 

viaSYSIPT 2.68,2.69 
viaSYSLOG 2.70,2.73 

executing PSERV 2.113 

executing RSERV 2.112 

executing SSERV 2.113 

executing SUM option of EREP A.80 

initializing SDAID 2.96 

initializing the transient dump 

process tape error statistics A.78 
Job stream trace, example of 2.167 



Label information cylinder 2.103 

format and contents 2.103 
for DASD labels 2.107 
for Tape labels 2.106 

function 2.103 

location, on SYSRES 2.104 

track allocation 2.105 
Label information display program (LSERV) 2.102 

example of output 2.108, 2.109, 2.110 

executing 2.102 

system requirements 2.102 

summary of information provided 2.102 

when and how to use 2.102 
Label save areas 4.106,4.107 
Layout of SYSRES 2.104 
Library display programs 2.111 

example of a DSERV output 2.114 

example of a RSERV output 2.1 15 

table of control cards 2.112,2.113 

when and how to use 2.111 
LIK A.5 
Linkage editor 2.181 

diagno stic of input 2.182 

error flags 2.182,2.183 

map 2.181 

summary 2.185 
Linkage registers 4.98 
List of flowcharts xi 
List of illustrations xi 
List of Program Interrupt codes 4.109 
List of tables xi 

List of WAIT STATE codes 2.176, 3.3, 3.4, 4.6 
Locating information blocks and save areas, see how to locate 
Locating partition communication regions 4.34 



INDEX 



Locating the POWER partition 

Log analysis displays (Model 115/125) 1.25, 2.230 

Logical IOCS 4.62 

using 4.65 
Logical transietn area 2.195 

dumping, see transient dump 
Logical transient owner identification key (LIK) A.5 
Logical transient key (LTK) A.5 
Logical unit block (LUB) 4.56 

explanation of the contents of 4.47 

format of 4.47 

how to locate 4.46 
Loop tracing 1.20 

instruction step method 2.146 
Models 135/145/155-11 2.147 
Models 115/125 2.149 
Model 158 2.151 

using the SDAID BR and or IF trace, example of 2.100 
Loops, see unintended program loop 
Low address storage 1.18,2.171 

contents of 2.174 

displaying 2.171 

example of, in a system dump output 2.175 

format of 2.175 

illustration of 1.18 

in a stand-alone dump output 

when to display 2.171 
LTK A.5 



M 

Machine Check Analysis and Recovery (MCAR) "2:1-96,. 

general flow of processing (illustration of) 2.192 
after hard machine check interrupt 2.192 
after soft machine check interrupt 2.192 

modes of operation 2.196 
Main storage alter trace 2.82 

when to use 2.82 
Maintenance program selection (Model 115/125) 1.25, 2.230 
Making a back up copy of SYSVIS (PDS), see SYSVIS dump 
Malfunction 

definition 1.6 

during program testing 1.6 

during single partition operation 1 .6 

in a multiprogramming environment 1.6 

using teleprocessing 1.6 
Manual frame (Model 158) 2.150 
MAP command 2.169 

example of 2.167,2.169 
Map, linkage editor 2.181 

example of 2.181 
Matching PUB 2 space 2.203 
Message 0S041 list of causes 4.24 
Message X'07E6' 2.167 
Messages, during SDAID initialization 2.88 

example of 2.96 

to initiate PDAID routines 2.62 
Methods of output 

for PDAID, see PDAID trace routines 

for SDAID, see SDAID trace routines 
Miscellaneous Data Recorder (MDR) 2.200 
MOD macros 4.68 
Model 115/125 display, examples of 

Address Compare 2.147 

ALTER/DISPLAY control registers 2.143 

ALTER/DISPLAY floating point registers 2.142 

ALTER/DISPLAY general registers 2.142 

ALTER/DISPLAY main (real) storage 2.143 

ALTER/DISPLAY protection key 2.143 

ALTER/DISPLAY PSW 2.142 

ALTER/DISPLAY selection 2.139 

ALTER/DISPLAY virtual storage 2.143 
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INDEX M (continued) 

Model 115/125 display, examples of (continued) 

Instruction Step 2.146 

Main(real) storage dump (Model 1 15/125 only) 2.160 

Maintenance program selection 1.25, 2.231 

Mode selection 2.139 
Model 115/125 maintenance log analysis 2.230 
Model 158 frames, examples of 

ALTER/DISPLAY frame 2.144 

INDEX FRAME 1.26,2.228 

MANUAL FRAME 2.150, 2.158 

SEREP FRAME 2.229 
Modes of output, for PDAID 2.40 
Module 4.68 

prefixes for IBM supplied modules 4.68 
Monitor call instruction A.9 
MVCOM macro 4.34 

N 

NICL 4.46 

how to locate 4.46 
Non-critical area 2.18 

locating 2.18 
Non-destroying dump 2.84 

discontinuing (stopping) before completion 2.84 

how to obtain 2.84 

when to use 2.84 
Non-translating dump, example of 2.25 

o 

OC option table 4.105 

Offline debugging, program debugging 1.27, 4.2 

Online Test Executive Program (OLTEP) 2.234 

description and operation 2.235 

features of 2.234 

illustration of 2.234 

uses of 2.234 
Online test terminal A.65-A.77 
Operators video console display unit 1.25 

see also Models 115/125 displays 

see also Model 158 
Operator commands for RMS 2.203 

illustration of 2.189 

Matching PUB2 space 2.203 

MODE 2.205 

ROD 2.203 
Operators flowcharts, for gathering information 3.3-3.25 

see also flowcharts, for the operator 
Options for CLEAR EREP 2.210 

EDIT 2.210 

HIST 2.214 

List of 2.209 

RDESUM 2.213 

SELECT 2.212 

SUM 2.211 

TES 2.215 
Organization of partition, and label save areas 4. 1 07 
Organization of SYSRES 2.104 
Organization of the supervisor, illustration of 4.33 
Output modes (devices) for PDAID 2.40 
Output information 

for PDAID 2.42, 2.45, 2.48, 2.50 

forSDAID 2.78,2.79,2.80 



Page frame table 4.114 

example of (in a dump output) 4.1 19, A.15 

format and contents 4.114 

how to locate 4.114 
Page frame table extension 4.114 

how to locate 4.114 



Page management tables 4.1 1 2-4.1 19 
boundary box 4.115 

example of dumping using SDAID output class 05 2.97 
example of interpreting in a dump output 4.119, A.15 
interrelationship, illustration of 4.1 17 
Page frame table 4.114 
Page frame table extension 4.114 
Page table 4.112 
segment table 4.112 
Page tracing routines 2.81 
example of 2.99 
when to use 2.81 
Page Table 4.112 

example of (in a dump output) 4.119, A.15 
explanation of the contents of 4.113 
format of 4.113 
how to locate 4.113 
initialization 4.112 
Page Enqueue Trace 2.76 
Page Handling Trace 2.76 
Page Translation Exception Trace 2.76 
Parameters 

for PDAID 2.62 
forSDAID 2.88 

for the MODE command 2.205,2.206 
for the Models 1 15/125 RMS, RMSR support 2.1 88 
for the Transient Dump 2.28 
Partition communication regions (COMREGs) 4.34 

how to locate, example of 4.34 
Partition Identification, see PIK 
Partition save area 4.1 06 

how to locate, example of 4.106 
PC option table 4.104 
PD address table A.2 

how to locate, see PD area 
PDarea 2.56 
dumping 2.56 
format and contents of 2.57 
locating 2.56 
PDAID and SDAID used together (concurrently) 2.40 
PDAID output, see examples 
PDAID trace routines 2.39 
caution before using 2.39 

description and operation of the trace routines 2.42 
dumping the PD area 2.56 
dumping the PDAID alternate area 2.60 
dumping the tape used for PDAID output (PDLIST) 2.41 
error messages 2.61 
F/L trace 2.45 

examples of output 2.47 
format and contents of a trace entry 2.45 
modes and output 2.46 
tracing options 2.46 
when to use 2.46 
General description 2.39 
GSVC trace 2.48 

examples of output 2.50 
format and contents of a trace entry 2.48 
modes of output 2.49 
tracing options 2.49 
when to use 2.49 
Job stream entry examples 
viaSYSIPT 2.69,2.70 
viaSYSLOG 2.72,2.73 
Modes of output 2.40 

core-wrap in an alternate area 2.41 
core-wrap in the PD area 2.41 
line printer 2.40 

magnetic tape 2.40 -\ 

when to use core-wrap output mode 2.41 
Operator's flowchart for initializing 2.63 
Printing the tape used for the PDAID output (PDLIST) 2.41 
QTAM trace 2.51 



P (continued) 

QTAM trace (continued) 
example of output 2.53 
format and contents of a trace entry 2.51 
modes of output 2.52 
tracing options 2.52 
when to use 2.52 

Restrictions 2.40 

Selecting the output device 2.59 
Specifying an alternate area 2.60 

System requirements 2.40 

Table of parameters 2.62 

Terminating 2.41 
PDAID transient dump, see Transient dump 
PDLIST 2.41 
PDUMP macro 2.32 

example of output 2.33 

format of 2.32 

information dumped 2.40 

when and how to use 2.33 
PD standard preface table A. 2 

how to locate, see PD area 
PHO option table 4.103 
Physical IOCS 4.62 

using 4.64 
Physical transient area 2.195 

dumping, see transient dump 
PIK A.3 
POWER /POWER RJE 

analyzing a dump of the POWER partition A.38-A.47 

analyzing a dump of the POWER RJE partition A.48-A.62 

analyzing a dump of the QFILE A.63-A.64 

serviceability aids for A.35-A.37 
PRINT GEN, PRINT NOGEN assembler language statement 

example of 4.70 
Printing the contents of SYSREC, see EREP 
Printing the contents of SYSVIS, see SYSVIS dump 
Printing the tape for PDAID output (PDLIST) 2.41 
Prefixes for IBM modules 4.68 
Processing tape error statistics 

using EREP 2.217 

using ESTVUT 2.219 
Program check interrupt 

causes 1.15 

definition 1.15 

example of 2.12,2.13 

isolation of cause, programmers flowchart 4.30 

inSVA 2.12,2.13 

list of codes 4.109 

operation action 1.15 

operator flowchart 3.25 
Program Event Recording (PER) A. 8 
Program Information Block (PIB) 4.88-4.91 

format of 4.89-4.91 

how to locate 4.88 
Program Information Block Extension (PIB2) 4.92, 4.93 

format of 4.93 

how to locate 4.92 
Program Interrupt Key (PIK) A.3 
Programmers flowcharts 4.2 

see also flowcharts 
Programmer Unit Block (PUB) 4.48-4.52 

examination of 4.48 

explanation of the contents 4.49-4.52 

format of 4.48 

how to locate 4.48 
Programming considerations for the Job Accounting Option A. 34 
Program Status Word 2.173 

displaying, dumping, SDAID output class 1 (PSW) 2.74 
see also console ALTER/DISPLAY operation 

format and contents 2.173 

locating 2.175 
PUB2 2.203 
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PUBOWNERSHIP, PUBOWNER 4.53 
format of 4.53 
how to locate 4.53 



Q 

QFILE, for POWER/POWER RJE A.63 
Queues 

error queue 4.62 

channel queue 4.56 
Quick reference list of serviceability aids 2.3 
QTAM trace 2.51 

example of output 2.5 3 

format and contents of a trace entry 2.5 1 

tracing options 2.52 

when to use 2.52 



R 

R AS transient area 2.195 
RDESUM, option of EREP 2.3 

examples of A. 80 
Real storage areas destroyed by the stand-alone dump program 

example of A. 12 

see also NON-CRITICAL area 
Real storage dump, see SDAID dump routines 
Recommendations for further problem analysis 

see flowcharts for the programmer 
Recognizing a malfunction 

a loop 1.8,1.12,3.12 

a wait state 1.10,1.12,3.12 

hardware error on Model 158 1.26, 2.232 

incorrect output 1.13, 3.12 

job/program canceled by system 1.15, 3.12 

program check interrupt 1.15,3.12 
Recovery from a hard wait, operators flowchart 2.1 89, 3.14 
Recovery from a soft wait 
Recovery Management Support (RMS) 2.188, 2.206 

components 2.195 

detailed description 2.196 

general description 2.188 

illustration of 2.189 

operation 2.190 

system requirements 2.188 
Recovery Management Support Recorder (RMSR) 2.189 

see also SYSREC 
Re-entrant modules 4.68 

Register Alternation, see ALTER/DISPLAY console features 
Reliability, Availability and Serviceability (RAS) 1.21 
Reliability Data Extractor (RDE) see IPL/EOD recording 

see also IPL reason information 

see also ROD command 
Relocation factor, example of using 2.13,2.100 

see also linkage editor map 
Restrictions, on use of 

ALTER command 2.7 

DSPLY command 2.9 

PDAID 2.40 

PDUMP macro 2.33 

SDAID 2.75 

SYSVIS dump 2.125 
ROD command 2.203 



Save areas 

ABSAVEarea 4.108 

Label save area, illustration of 4.107 

partition and label save area 4.1 06 

how to locate 4.106 
save areas for job accounting 4.1 1 1 
system save areas 4.110 
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Save areas (continued) 

user exit routine save areas, illustration of 4.109 
save usage command 2.164 
SDarea 2.85 

SDAID and PDAID used together (concurrently) 2.77 
SDAID initializing output, example of 2.95 
SDAID output, see examples 

SDAID output classes, table of, for the elementary events 2.79 
Output class COMREG, (04) 2.79 

Output class DUMPREAL (Non-destroying dump) (07) 2.79 
Output class FASTREC, (00) 2.79 
Output class GPR, (02) 2.79 
Output class LOCORE, (03) 2.79 
Output class PAGETAB, (05) 2.79 
Output class PDUMP, (08) 2.79 
Output class PSW (01) 2.79 
Output class SUPVISOR, (06) 2.79 
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DOS/VS Serviceability Aids and Debugging Procedures 

THIS MANUAL... PREFACE 

... is intended to guide System/370 operators and programmers using DOS/VS in 
determining and isolating the cause of a system malfunction. 

METHOD OF PRESENTATION 

Serviceability aids and how to use them are described in this manual through 
extensive use of diagrams and examples. This enables fast retrieval of information 
and largely avoids the need to use other publications in order to analyze the dumps 
and printouts discussed. 

Contents and addresses shown in the illustrations are subject to change and are 
shown only as an aid to offline debugging of DOS/VS release 29.. IBM will not be 
responsible for any system malfunction resulting from a change made by the 
user of any contents or addresses of the tables and blocks described. 

SUBJECTS COVERED 
There are four major sections; 

SECTION 1: Introduction, introduces the serviceability aids detailed in Section 2, 
and the debugging procedures described in Sections 3 and 4. 

SECTION 2: Serviceability Aids, describes in detail the serviceability aids, 
showing in flowchart form how to use them, and recommending when to use them. 
Examples show how to analyze dumps and printouts in conjunction with the 
debugging procedures of Section 3 and 4. 

SECTION 3: Debugging for Operators, consists of flowcharts that help the 
operator to isolate the cause of a system malfunction. The operator is instructed 
when to use the procedures of Section 2 to ensure that information is gathered 
from the system. 

SECTION 4: Debugging for programmers, this section is divided into two parts: 

Part 1 consists of checklists in flowchart form that recommend the method of 
analysis and choice of serviceability aids best suited to isolate the cause of a given 
type of system malfunction. An indication is made on the flowcharts when it is 
considered necessary to inform your IBM customer engineer when it is not 
possible to isolate the cause of an error. System information to be saved for the 
IBM CE is also listed at thege points in the flowcharts. 

Part 2 is a general description of the DOS/VS supervisor/problem program interface 
tables, information blocks and save areas. It shows how to locate these areas in a 
dump, and how to analyze the data during offline program debugging. Debugging 
aids for high level languages are described in publications dealing with the specific 
language. 

PREREQUISITE KNOWLEDGE 

Operators using this manual must be familiar with the following IBM publications: 

DOS/VS Operating Procedures GC33 - 5378 

DOS/VS Messages GC33 - 5379 

Programmers using Section 4 must be familiar with the following IBM publications: 

IBM System/ 3 70 Principles of Operation GA 22 - 7000 

DOS/VS System Management Guide GC33 - 5371 

Other IBM publications referenced in this manual are listed in the bibliography at 
the back. 

iii 
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*CE , SE, IBM CE/SE is the 
IBM representative 



PRT Partition 

PSLD Private second level directory 

PSW Program Status Word 

PT Page Table 

PTA Physical Transient Area 

PTF Program Temporary Fix 

PTR Pointer 

PUB Physical Unit Block 

QTAM Queued Telecommunication Access Method 

RAS Reliability, Availability, and Serviceability 

RDE Reliability Data Extractor 

REQID I/O Requestor Partition or System Task Identity 

REQD Required 

RF Recorder File 

RID Routine Identifier 
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STAB Segment Table 
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TIK Task Interrupt Key 

TKREQID I/O Requestor's Task Identity 
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VDU Virtual Display Unit 

VSAM Virtual Storage Access Method 

VS Virtual Storage 

VTOC Volume Table of Contents 

WTM Write Tape Mark 

X' ' Hexadecimal Value 

YR Year 
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A dump is a program or an operation that prints the image, in hexadecimal format, 
of a selected area of virtual storage. This term is also used when an area of virtual 
{ storage is recorded or stored on magnetic tape or on a disk pack 

Figure 1 -4 illustrates the various type of dumps offered by IBM. Section 2- A of 
this manual describes how to execute the dump programs and operations, and 
discusses the meaning of dump output that is useful during offline program 
debugging. 



Gathering Information 

STORAGE 
DUMPS 



A dump of the 
real address area. 

Stand-alone dump. 



i 



Real 


i 


address 




area 




Virtual 




address 




area 


' 



■Eaii 



A dump of the 
virtual address area. < 
SYSVISdump. 



V 



LOW ADDRESS STORAGE 



SUPERVISOR 



PROGRAM A 



PROGRAM C 



PROGRAM D 

v/w/////////////. 



PROGRAM E 




A dump or display of the 
low address storage. 

Attention routine commands 
and operator's console. 



A dump of a partition in the 
real or virtual address area. 
This is referred to as a 
Partition dump or a System 
dump and includes a dump of 
the supervisor area. 
System generation option, 
job control statement, job 
control command, and 
assembly macros. 



A snap shot dump used to 

display small parts of a 

program at any selected 

area. 

Attention routine commands and 

assembly language macros. 



A dump of the SVA 

Partition dump or a System 
dump includes a dump of 
the SVA (or part of it) if 
a program check occurs 
in the SVA. 







Figure 1-4. Storage dumps. 

Various areas of storage can be dumped or displayed using the IBM dump 
programs and console aids. 

(The dividing point between real and virtual address areas depends on the size 
of the hardware memory on your System/370). 
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Gathering Information 

LOOP TRACING 



Three methods of tracing or recording the path of a loop are provided on the 
System/370: 

1 . By using the facilities provided by the operator's console, the operator can 
list the addresses of the instructions used by the loop. 

2. By using the successful branch routine of the SDAIDS. 

3. By using the instruction fetch trace of the SDAIDS. 

All three methods are described in Section 2. The first method is useful to trace 
small loops during hands-on debugging. However, the amount of time that may be 
spent tracing a loop by this method depends on the answer to the following: 

1. How important is it to system operation that the loop be fully traced? 

2. How will the time spent tracing the loop affect system commitments? 
Normally the operator is not in a position to answer these questions and if the 
programmer or the DP manager is not available, he can only take a short trace. 
The second and third methods can be used either during hands-on debugging, or 
during re-runs of the program generating the loop. 



A note to operators 

Before tracing a loop by using any of the above methods, you must consider their 
effects on time-dependent programs currently running in the system. Such 
programs are, for example, those using magnetic ink character recognition or 
teleprocessing equipment as input/output devices. 

Guidelines on how to isolate an unintended loop and trace it are given in 
flowcharts in Sections 2 and 3. 



( 
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Dumps of, and changes to Real and Virtual Address Areas 



I 



Restrictions 

1. If the sixteen bytes cross the boundary from a valid to an invalid address space 
(see the third restriction, below) only the bytes in the valid address space are 
displayed, and the following message is issued on SYSLOG: 

11481 XX BYTES COULD ONLY BE DISPLAYED 

2. If the highest available virtual storage address is exceeded before sixteen bytes 
are printed, the command is terminated. However, the contents of those 
bytes that fall within the virtual address area are printed. 

3. If the specified address is within an invalid address space the following message 
is issued on SYSLOG: 

1I41D INVALID ADDRESS 

The definition of invalid address space is listed under item three of "Restrictions" 
in the description of the ALTER command. 

When to use 

This aid can be used during hands-on debugging, or an operator can be 
instructed to use it at specific addresses in a program. 

For instance, loop count areas, small areas modified by loops, or parts of I/O 
areas can be dumped or displayed during program execution. The dump 
information will help during offline program debugging. 



OPERATOR COMMANDS 
(DSPLY) 



Serviceability Aids. 



2.9 
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Dumps of, and changes to Real and Virtual Address Areas 



OPERATOR COMMANDS 
(DUMP) 



The DUMP Command 

To activate the DUMP command press the REQUEST key and enter DUMP. The 

command allows the operator to display large areas of virtual storage on SYSLST. 

The SYSLST used may be assigned to any partition, but it must be a printer and it 

should not be in use by the partition. If the same printer is being used by the 

partition, the printed output will be a mixture of dump and partition output. 

If SYSLIST is assigned to a 321 1 printer and the printer's indexing feature 

is being used, a certain number of characters may get lost on each line of 

the dump. To avoid this, the operator should load a new FCB (forms control buffer) 

image to disable the indexing feature before he issues the DUMP command. 

The new FCB image can be loaded either by issuing an LFCB command 

or by executing the SYSBUFLD program. 



Operation 


Operand 










DUMP 




S 
BG 


(BG) 
(Fna') 


* Note 1 






Fn 


_i 






BGS 








FnS 








PDAREA 








xxxxxx, xxxxxx 











n,n' = 1,2,3,4 



Note: 



If the first operand is omitted, the general registers, control registers, and all 
storage that is currently used by programs, except that used by the supervisor 
(unless the operand BGS or FnS is specified), will be dumped. See note 2. The 
storage used consists of: 

1. Real storage not belonging to the page-pool 

2. The virtual partitions in which a program is currently running. 



Description of the operands: 



Operand 


Meaning 


S 


Causes a dump of storage used and the supervisor area. See note 2 


["] 


Causes a dump of the specified partition and its associated registers. 
If a real-mode program is running in the specified partition, the temporary 
real partition is dumped. If a virtual-mode program is executed in the 
specified partition, the whole virtual partition is dumped. 


rBGS] 
LFnsJ 


Causes a dump of the same areas as described for the BG/Fn operand. 
However, the dump will include the supervisor area. 


PDAREA 


The PD area and the registers will be dumped (See Section 2, B-3 for 
details and a description of the PD area.) 


XXXXXX, 
XXXXXX 


Specifies the starting and ending address of virtual storage, with 
associated registers, that is to be printed. If the starting address is not on 
a fullword boundary, the address is rounded down to the first fullword 
boundary; if the ending address is not on a fullword boundary, the 
address is rounded up to the first fullword boundary. A minimum of one 
fullword is dumped, beginning at the start address. 



Note 1: 



BG 

F1 

F2^ 

F3 

F4 



When any of these additional operands are specified, the area of virtual storage 
specified by the first operand is dumped on the SYSLST assigned to the partition 
specified by this operand. SYSLST must be a printer and should not be in use by its 
assigned partition. If the same printer is being used by the partition, the printed output 
will be a mixture of dump and partition output. 
(If this operand is not specified, the SYSLST printer assigned to BG is used. See note 2.) 



2.10 Serviceability Aids. 



) 
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Dumps of, and changes to Real and Virtual Address Areas 

Control statements for the DUMPGEN operands D U MPG E N AN D 

^ u , , , r „ , STAND-ALONE 

Control statements may be specified in any order; however, the following rules ni IMP 

apply: 

• All statements may be omitted, but if they are, DUMPGEN assigns printer 
X'OOE', INTR=NO, FORMAT=NO, and PPOOL=NO options. 

• Only one operation and only one operand per control statement is allowed. 

• The last statement processed of a duplicate operation overrides all previous 
statements of the same operation with similar operands (if DECKS=2 is 
followed by DECKS=5, five decks are punched). 

• The name field must be blank. 

• Decimal operands may contain leading zeros. 

• One of more blanks must follow the operand if comments are to be made. 

Job stream example 

The following example is a typical job used to create a stand-alone dump. 

//JOB 

// EXEC DUMPGEN 

Col. 2 

ASSGN SYSLST, X'OOF' 
OPTN FORMAT=YES 
OPTN PPOOL=YES 
OPTN DECKS=5 

/* 
/& 

Note: If a 3221 is the only printer in your installation, the indexing feature 
should be used with great care; shifting the print line to the left 
or too far to the right causes loss of a certain number of characters 
on each line of the dump. 

DUMPGEN messages 

The functions of DUMPGEN-to-opera tor error message routines are: 

• Cancel the job if SYSLOG is not a 3215/3210 or a System/370 Model 125/1 15 
video display unit. 

• Reissue the message if operator response is to press the CANCEL key 

• Process an operator response of END/ENTER as IGNORE 

• Cancel the job if operator response is CANCEL. 

• Ignore the control card in question when the operator response is IGNORE. 

If none of the preceding operator responses is issued, then DUMPGEN assumes 
that a correction has been made and processes it. 
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Dumps of, and changes to Real and Virtual Address Areas 

DUMPGEN AND Stand-alone Dump Program 

STAND-ALONE 

DUMP This program is generated for your installation using the IBM program DUMPGEN. 

DUMPGEN produces a dump program that is either punched into a card deck or 
stored on magnetic tape. When required, the dump program thus generated can be 
loaded into the system via the standard IPL procedure. 

The stand-alone dump program that is generated by DUMPGEN provides either 
a conventional dump or a formatted dump, depending on the FORMAT option 
used in the DUMPGEN program. 

Operation 

During execution of the stand-alone dump program, a non-critical area in the 
supervisor is used to load the program. The LOAD ADDRESS of the non-critical 
area is punched (in decimal) in the first card of the stand-alone dump card deck 
punched by the DUMPGEN program. Because of this use of the non-critical 
area it is recommended to use the stand-alone program for a system using a 
supervisor that was used for the generation of that dump. 

The conventional dump prints the contents of real storage locations, but does not 
dump the floating point registers. In addition to the areas dumped by the conven- 
tional dump, the formatted dump prints the DOS/VS interface tables in a more 
readable form. 

For both types of dump the following is printed: 

1 . The contents of the general registers, the old and new PSWs, the interruption 
codes, CSW, CAW, and TIMER. 

2. The contents of real storage in 2k blocks. Each block is preceded by a 
sequence number. 

3. At the end of the real storage dump, page address and status information is 
printed that contains the following information for each page frame: 

• The virtual address 

• The real address of the associated page 

• The sequence number of the 2k block 

• Information that indicates whether the contents of the page frames 
has been changed. 

4. The contents of the control registers are printed after page address and 
status information. 

5. Depending on the options selected, the following then occurs: 

If PPOOL=YES 

• The formatted contents of the boundary box is printed after the 
control registers. 

• The contents of real storage is printed in 2k blocks in sequence of 
ascending virtual addresses. 
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Dumps of, and changes to Real and Virtual Address Areas 

DUMPGEN AND 

STAND-ALONE 

DUMP 



Start 



Before executing, dump, 
or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 
X'OO'-X'BF' 



) See D-1 -F for Models 1 35, 1 45, 1 55-1 1 
UndD-2-F for Models 1 15, 125 
landD-3-F for Model 158 





YES 



Dump program 
on card deck 



Mount tape on a tape 
unit ensuring that the 
number of tracks and 
density is identical to 
that used when the 
tape was produced 



Place card deck in a 
card reader 



Set address switches or 
set address in display of 
the tape unit 



Set address switches or 
set address in display of 
the card reader to be 
used 



A 



To next page 
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Dumps of, and changes to Real and Virtual Address Areas 



DUMPGEN AND 

STAND-ALONE 

DUMP 




From previous page 



Press the STOP key, 
the SYSTEM RESET 
key, and the LOAD 
key, in that order 



A wait state occurs if 

INTR YES is specif ied 

during generation of the 

dump program using DUMPGEN. 



The contents of REAL storage is 
printed in blocks of 2K bytes on 
the line printer specified in the 
ASSGN statement of DUMPGEN 
or the line printer made ready 
after entering the WAIT STATE. 
Other information is also printed 
depending on the type of dump 
program generated by DUMPGEN. 




YES 



Press the INTERRUPT 
key, or the START 
button on the printer 
desired as output device 



The DUMP is 
executed 



r 



y 



The SYSVIS dump utility program 
is described under C-6 in this Section 



V 



The following procedure executes the SYSVIS dump utility program. This 
procedure copies the PDS to tape or disk which can then be dumped to SYSLIST 
if required during offline debugging. It is also possible to dump the PDS directly 
to SYSLST. To ensure that the contents of the PDS and the allocations of the 
virtual address area are the same as they were just prior to the execution of the 
stand-alone dump the following instructions must be adhered to: 

1 . Re-IPL using identical parameters for the DPD command as specified in the 
previous system IPL. However you must specify N to the parameter TYPE=. 

2. Check for any previous ALLOC commands. You must specify identical virtual 
partition allocations as existed just before the stand-alone dump was executed. 



Example 1 

// JOB DUMPPDS 

// ASSGN SYS000,X'cuu' 

// ASSGN SYS001,X'cuu' 

// DLBL PDSDISK/PAGE DATA SET' 

// EXTENT SYSOOO 

// DLBL S01DISK/BACKUP FOR PDS', 

// EXTENT SYS001 ,1 11111 ,1 ,,0020,180 

// EXEC PDSDM 

/& 



Example 2 

// JOB DUMPPDS 

// ASSGN SYS000,X'cuu' 

// ASSGN SYS001,X'cuu' 

// DLBL PDSDISK/PAGE DATA SET' 

// EXTENT SYSOOO 

// TLBL S01TAPE/BACKUP FOR PDS' 

// EXEC PDSDM 

/& 




YES 



Use the SYSVIS dump to 
copy the PDS to disk. 
See JCS example 1 



Use the SYSVIS dump to 
copy the PDS to tape. 
See JCS example 2 



Wait for message 0V20D 
on SYS LOG then press END 



Save the copied PDS for your 
system programmer and /or 
IBM CE/SE. He may need 
it to complete offline 
program debugging. 



Continue normal processing 
with the next job 
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Dumps of, and changes to Real and Virtual Address Areas 

TRANSIENT DUMP 
Initializing the Transient Dump 



//JOBDUMPTA 
// EXEC PDAID 



4C10DPDAID = 



Enter XX 
and press 
END 



Enter TD 
and press 
END 



Press 
END 



4C11D OUTPUT DEVICE = 



Terminate 
Transient Dump 



Select output 
device 



Read Parameters 
from SYSIPT 



A-4-F 



Transient Dump 
is initiated 




Print the Transient 
Area 



//EXEC PDAID 

PDAID=XX 

/• 

// ASSGN SYS005 f X'cuu' 

// MTC REW,SYS005 

// EXEC PDLIST 

/* 

/ ! _ J _ 



The LTA and PTA will be 
dumped on the selected output 
device if a program check interrupt 
occurs in the transient area 



Print dump using 
PDLIST utility 
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Dumps of, and changes to Real and Virtual Address Areas 

TRANSIENT DUMP Job stream examples 



The following two examples show job stream to initiate the transient dump 
program. 

Example l.viaSYSIPT: 

//J0BCARDINP7 

// EXEC PDAI D Calls for initializer. 

PDAID=TD Calls for transient dump function. 

OUTPUT DEVICE=00E Specifies printer output. 

GO Signals end of input. 

/• 
/& 

Note: A dump is given on all program checks. 



Example 2, via SYSLOG: 

//J0BTYPINPT6 

// EXEC PD AID Calls for initializer. 

PDAID= Console requests function. 

TD and END key Operator specifies transient dump function. 

OUTPUT DEVICE= Console requests output device. 

00E and END key Operator specified printer output. 

An output device must be specified for the transient dump fiction. 

If this is a 321 1 printer and the printer's indexing feature is used, 

it may occur that not the full length of every line of the dump is ' \i 

printed. This Joss of characters can be avoided by disabling the <i 

indexing feature. This is brought by loading a new FCB image into 

the printer's FCB in one of the following ways; 

Using the SYSBUFLD program. 

This method is to be used when the transient dump is entered via 

SYSIPT. The job stream as shown in example 1, 

would than have to be as follows: 

// JOB 

// EXEC SYSBUFLD 

FCB SYSxxx,phasename 

/* 

II JOBCARDINP7 
// EXEC PDAI D 



Using the LFCB command 

This method is to be used when the transient dump is initialized 
by means of the console printer keybord (SYSLOG). The job 
stream as shown in example 2 would then be as follows: 

LFCB X'cuu',phasename 
//■ JOBTYPINPT6 
//EXEC PDAI D 



phasename = the name by which the FCB image is cataloged. 



2.30 Serviceability Aids. 



Trace Routines 

Two series of trace routines are provided on the System/370: PDAIDS and PD Al DS 

SDAIDS 

These aids enable information to be obtained from the system at the time of a 
malfunction. They are aids for further error isolation, and are usually initiated 
during a rerun of a troublesome program after a first analysis of the problem. 
The type of trace to use for a particular problem depends on the result of the 
first analysis and how much more information is required to help in further 
isolation of the error. 

This section is divided into two parts: 

Part 1 describes the PDAIDS, and part 2 describes the SDAIDS. 

PART 1 PDAIDS 

General description 

There are four trace routines that can produce printed output of certain events 
which occur during the execution of programs. 

The trace routine will: 

• Record I/O operations (I/O trace) 

• Record the order in which phases and transients are called (Fetch/Load trace) 

• Record the order in which supervisor calls (SVCs) are executed (Generalized 
SVC trace) 

• Record the order in which either an SVC or an SVC 31 , and I/O 
interrupts occur. (QTAM trace). 

On the occurrence of an event, an entry is generated which, by selection of the 
trace, can be recorded on magnetic tape, printed on a line printer, or preserved 
either in the PD area or, if specified, in an alternate area of real storage. 

Caution 

The effect on the operation of programs currently running in the system 
that are time dependent, for example, a program using MICR or teleprocessing 
as input/output, must be considered before using this serviceability aid. 
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System requirements 



Before any PDAID function can be executed, the following requirements must 
be met: 

• During the system generation, specify a minimum value of 1400 in the PD 
parameter of the FOPT macro. (The maximum value is 10,240). 

• If data provided by the trace routines is recorded on magnetic tape, use 
the PDLIST program after tracing is complete to obtain a printout of the 
tape. 

All PDAID modules are distributed by IBM in the core image library. 
They are self -relocating for initialization in any real or virtiual partition 
(6K or greater) of a multiprogramming system. 



Restrictions: More than one PDAID trace routine cannot operate concurrently. 
This also applies to the PDAID Transient Dump program described in Section 
2-A-4. Therefore, more than one program rerun must be executed if more than 
one PDAID function is used to gather information about a failing program. 



Using PDAID and SDAID concurrently: IF SDAID is active it must first be 
terminated before initiating a PDAID trace in core-wrap output mode in an 
alternate area. 



Modes of output 

Line printer: (not available as output mode for QTAM trace) Examples in this 
section show the trace outputs when the output device is a line printer. An 
asterisk on the print-out indicates that at least one event (trace entry) has been 
overwritten. This occurs when an overflow is caused in the trace table in the 
PD area (described in B-3) or in an alternate area. This may occur when the trace 
output device, or its control unit, or channel, is shared with other programs 
running simultaneously. 

If the printer is not ready or has an error condition, message 4C24A NO I/O TO OD 
is printed on SYSLOG and the system waits for the END/ENTER key to be 
pressed after the printer is made READY. 

Magnetic tape: This mode of output collects and writes on an unlabled tape the 
trace entries that occur during execution of a job stream. 

The events are written on tape in core image (unprintable) format. 

The tape must be processed using the PDLIST utility. The tape unit must be 
assigned temporarily or permanently to SYS005 and SYSLST assigned temporarily 
or permanently to a line printer in order to obtain readable listings of the events 
traced. Examples in this section show the output format after using the PDLIST 
utility. 

If the tape unit is not ready or has an error condition the message 

4C24A NO I/O TO OD 

is issued on SYSLOG and the system waits for the END/ENTER key to be 
pressed after the tape drive is made READY. 
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Trace Routines 

PDAIDS 



/ 



Virtual Storage 

/\ 

/ \ 

/ \ 



Label 

PD AREA 



\ 



LOW ADDRESS STORAGE 



SUPERVISOR 



PD AREA 



PAGE POOL 
unless it belongs 
to BGR 















PD Address Table 




PD Standard 
Preface Table 




PD Event 
Handling 
Routine area 




SLOT1 


NEXT 


WRAPADR 




PD Buffer. 
Used for core-wrap 
output, or PDAID 
event handling. 



For details of 
contents, see 
Appendix A. 



/ 



/ 



,1 

I 
I 



PD buffer, when 
used as core-wrap 
output mode. 



'Last 12 bytes in PD 
Event Handling Area 



/ 



FIRST entry, 



NEXT entry, 



LAST entry, 



Note: 

See Section 4 for details about the supervisor organization. 



Trace type. 



Input/output 



Fetch/load 



GSVC 



QTAM 



SLOT1 



Contains address of 

FIRST entry in PD 

Buffer. 

It is found at: 



PDAREA + 1B4 



PDAREA + E8 



PDAREA + X"I14' 



PDAREA + '1 CO' 



NEXT 



Contains address of 
NEXT available entry 
in PD Buffer. 
It is found at: 



PDAREA + 1B8 



PDAREA + EC 



B = A + 4 



B = A + 4 



WRAPADR 



Contains address of 

LAST entry in PD 

Buffer. 

It is found at: 



PDAREA + 1BC 



PDAREA +F0 



C = A + 8 



C = A + 8 



Length of one 
entry in bytes; 



18 (dec) 



22 (dec) 



18 (dec) 



21 (dec) 




Maximum number 
of entries in the 
minimum PD area 
of 1400 bytes (dec) 



52 



52 



61 



44 



Notes: 

1. NEXT - address of the next available entry in the PD Buffer. TJie NEXT entry 
in the PD Buffer contains either the oldest entry in the t«ble, or the most recent 
entry of a device, SVC, or partition being ignored (all entries are placed in the 
NEXT entry before they are checked for trace or ignore). If the latter is the case, 
ignore the entry. 



2. When the LAST entry is filled, the address in SLOT1 is loaded into NEXT and 
the buffer is overwritten by new entries. 



Table B-3 Trace entry locations and lengths for core-wrap output mode in the PD area. 
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Trace Routines 

PDAIDS 



Initiating the PDAID trace routines 

You can initiate PDAID trace routines by using standard DOS/VS job control 
languages from either SYSLOG or SYSIPT. The statement 

//EXEC PDAID 

causes the main phase (PDAID) to be loaded at the address of the initiating 
partition. Control is given to the PDAID for further specifications to indicate 
the type of trace to be performed. 

The options and control statements for the trace routines may be entered through 
SYSLOG or through the device assigned to SYSIPT. 

If a-card reader is used as SYSIPT, the card deck must be punched as follows: 

Entries may be punched one-per-card, or as multiple entries (separated by commas) 
in a single card. An entry may not be split between two cards. All 80 columns of a 
card may be used, but a card is terminated either by the first blank following an 
entry, or by a GO entry. The last card must be followed by a /* CARD. 

Note: If an incorrect parameter is read from SYSIPT, corrections are requested on 
SYSLOG. 

When the initializing phase (PDAID) has been loaded, the following message is 
issued on SYSLOG: 

4C10DPDAID= 

The operator must respond to this message with one of the following: 

IT Specifies an I/O Trace (See note 1 .) 

FT Specifies an F/L Trace (See note 1 .) 

GT Specifies a GSVC Trace (See note 1 .) 

QT Specifies a QTAM Trace (See note 1.) 

TD Specifies the Transient Dump 

(refer to A-4 in this Section) 

XX Terminates the PDAID presently running 

Pressing the END or ENTER key indicates that PDAID control statements are 
entered through SYSIPT (See note 2.) 

Notes: 

1. When IT, FT, GT, or QT is specified, the operator must provide additional 
PDAID control statements through SYSLOG. 

2. The END response is valid only for SYSLOG and cannot be used as a SYSIPT 
operand. 

3. Multiple operands or operator responses to PDAID control statements for traces 
with a variable number of functions (such as ignoring SVCs) are not allowed. 
Repeat each parameter with each variable). Repeat each message until either 
the maximum number of variables is reached or an END response is given. 

4. GO terminates the PDAID control input, and the default is taken for any 
PDAID options that are not specified. When you use SYSIPT, GO should be 
the last parameter, and it has no operand associated with it. A I* card must 
follow the GO operand. 
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Dump on a program check: On the occurrence of a program check interrupt codes 
X'01' - X'OF', X'10', and X'12\ the following information is dumped automatically: 



Trace Routines 

SDAIDS 



Event ID 

Program old PSW 

Time of day in microseconds 

Control registers 

• General purpose registers 

• Real storage from byte location to the end of the supervisor area, and the 
contents of the SDAID buffer. 

After this automatic non-destroying dump is executed, the DOS/VS program 
check handler routine will be entered. 

When to use: If PD AIDS are not available on your system, the use of the SDAID 
dump on a program check is the only way to obtain a non-destroying dump of the 
supervisor transient area at the time of a program check interrupt. 

The SD area 





SUPERVISOR 


"1 Real Partitions j 
j if any. ]_ 


SUPERVISOR 
















MAIN 
PAGE 
POOL 


MAIN 
PAGE 
POOL 






"" 


1 SDAI D resident code 
j and work space. 

V SD Buffer 


' 


SD AREA 
(6K by default) 


END OF 
REALST( 


DRAGE 


/ 
END OF 
REALSK 


DRAGE 


Length of each event is 64 


Dytes. 



Real storage allocation 
before initializing SDAIDS 



Real storage allocation 
after initializing SDAIDS 



How to locate 

The address of the beginning of the SD area is printed on the device assigned to 
SYSLST during initialization of SDAID. Refer to page 2.90 for an example of 
SDAID initializing output. 
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Initializing SDAID 

SDAID may be initialized in any real or virtual partition by entering the following 
execute statement via SYSLOG or SYSRDR: 

// EXEC SDAID 

An operator/system dialog follows, beginning with the message: 

4C55D GIVE SPACE FOR SDAID= 

The operator may respond by pressing the END key (which gives a default value of 
6K to SDAID), or he may specify a value nK, where n represents a multiple of 1024 
bytes. The maximum value that may be specified is 999K. If an odd number is 
specified, the value is incremented to the next even number. The SDAID space is taken 
from the main page pool. If the main page pool is not large enough to accept the 
area specified, an area of the size PPOOL-16K is automatically taken, with a minimum 
of 6K. If the page pool is not large enough to accept the minimum(6K), the following 
message is printed on SYSLOG. 

4C56E INSUFFICIENT SDAID SPACE, REALLOCATE 

The MAP command should be issued before reallocating real partition areas in 
order to increase the size of the page pool before re-initializing SDAIDS. 

The following message will be issued if this is a second request for SDAID space: 

4C70E DUPLICATE REQUEST FOR PDAID AND/OR SDAID 

This message is also issued if PDAID using the core wrap output mode in an 
alternate area is active in the main page pool and a request for SDAIDS is made. 
When the space allocated to SDAID is accepted, a message dialog follows that allows 
the operator to select one or more events to be traced and to specify between which 
address limits of real or virtual storage the events are to be traced. (Event limits 
do not apply to event PAGENQ, event PAGEHDL, and event PGMCHK.) The dialog 
also enables the selection of a line printer at a device address other than X'OOE', 
which is the device address by default. However, the device must be a line printer. 

An output class may also be specified (refer to Tables B-6-A and B-6-B in this chapter). 
A response of EOB (pressing the END key) to all SDAID messages will give default 
values. 

When the SDAID message dialog is complete, the SDAID initializing outputs part 
1 and 2 are issued to the device assigned as SYSLST. This need not be the same 
device on which SDAID trace output is printed. The SDAID trace output is printed 
immediately after the initializing output on the device at the address specified in 
the reply to message 

4C58D OUTPUT DEVICE= 

(Address X'OOE' is taken as default.) After initialization, the partition used for the 
initialization is given back to the main page pool. 

The table shown in Figure B-3 lists all SDAID messages in the order in which they 
are issued and describes the responses. 

SDAID job entry examples are shown after the example of the SDAID initializing 
output. Operator flowcharts follow. 

SDAID messages after initialization time 

4C71I SDAID FOUND PRTR STATUS CSW SENSE 

This message may be written out on the printer. It is accompanied by the CSW and 
SENSE information if applicable. It indicates that the previous printer operation 
which was started may not have been completed successfully. 
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Altering SDAID functions and /or address limits after initialization 

When the SDAID is initialized, trace functions and events limits, where applicable, 
can be changed by altering the SDAID program parameters directly in storage. 
The contents of the parameters at the addresses printed on part 2 of the SDAID 
initializing output, and of control registers 8, 9, A, and B, must be altered to 
predetermined values. Their values are also printed in the initializing output. 

To make SDAID parameter changes: 

• Press the STOP key. 

• Use the console ALTER/DISPLAY feature to alter the contents of the 
program parameters. 

• Press the START key. 

Note: When SDAID is terminated and later re-initialized, new SDAID parameters 
are printed in the SDAID initializing output 

Note: SDAID requires SYSLSTfor the initializing output. Therefore, if you 
intend to change SDAID parameters after initializing SDAIDS, you should ensure 
that the SYSLST device is a line printer on the partition used for SDAID 
initialization. 
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1 

W 



A note to programmers 

SDAIDS are primarily designed to be initialized before re-running failing programs. 
If you, as the programmer, are debugging on the system (hands-on debugging), it 
is recommended that you initiate SDAIDS without specifying any events. (Press 
the END key as a response to all SDAID messages.) SDAID is then retained in the 
page pool ready to be activated. The failing programs can then be executed and 
SDAID events made active by entering event parameters directly into control 
registers 8, 9, 10, and 11. For example, altering the contents of the high-order byte 
of control register 9 (by the console ALTER/DISPLAY feature) enables you to 
activate any one or all of the events BR, IF, SA, and GA. 

You can also specify which general registers are to be traced by entering values 
into the lower 2 bytes of control register 9. Control registers 10 and 1 1 contain, 
respectively, the start and end addresses for the event limits. The output of the 
MAP command will tell you the partition in which the failing programs reside. 

From the MAP output you can also obtain the addresses of the upper and lower 
limit of the partition, which can then be used as the event limits for the SDAID 
trace. (Note that addresses printed by the MAP command are decimal.) 

If you are unable to use the system for hands-on debugging, you as the programmer 
must specify clear instructions to the operator about the events to be traced and 
the event limits to be used. 
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Message 
Code 


Message issued 
on SYSLOG 


Parameters entered by Operator 


Remarks 


4C58D 


OUTPUT DEVICE= 


'X'OOE' [,GO]' 
X'cuu' [,GO] 
GO 


END/ENTER 




4C60D 


STOP ON EVENT= 


YES r „ , 
NO t' G °] 


END/ENTER 




4C61D 


EVENT LIMITS^ 


X'000000',X'FFFFFF' 


.[.GO] ■ 
LGO]1 
[.GO] 


END/ENTER 


X'llllll'.X'hhhhhh': 
Lower and upper limit of virtual 
storage to be traced with events 
BR, IF,SAandTE. 


X'llllll' ' 


X'llllll' 

X'hhhhhh' 

GO 


4C59D 


OUTCL= 


PSW 

GPR 

LOCORE 

COMREG 

PAGETAB 

SUPVISOR 

DUMPREA 

PDUMP 
FASTREC 


L 

,lowe 
,X'aa t 

_,GO 

,PGM 
,AUT 
,GO 


,GO 

r and 
aaaa' 

CHK 
OMA 


upper event 
,Upper evenl 
,X'bbbbbb' 
..GO 

[.GO] 
TIC [,GO] 


imit [,GO] 
t limit [,GO] 
COO] 




END/ 
ENTER 


Valid output classes for the events 
BR, IF,SA, GA, andTE. 
END/ENTER 

PGMCHK: Causes wrap around 
mode of internal buffer. It is 
written each time a PGMCHK 
event occurs. AUTOMATIC: 
If the internal buffers is full, 
it is written out. 


4C62D 


EVENT BR= 


><>]' 


END/ENTER 




4C63D 


EVENT IF= 


L'H 


END/ENTER 




4C64D 


EVENT SA= 


5 S H 


END/ENTER 




4C65D 


EVENT GA= 


X'012...EF' [,GOJ 
NO 


END/ENTER 


Designate the general purpose 
registers to be traced. At least 
one must be specified. 


4C66D 


EVENT TE= 


E? ^ 


END/ENTER 




4C67D 


EVENT PGMCHK= 


W 1 w 


END/ENTER 




4C68D 


EVENT PAG ENQ= 


U s tG0 i 


END/ENTER 




4C69D 


EVENT PAGEHDL= 


yes' 

NQ . 


END/ENTER 





Note: Go cannot be entered as a first parameter. If it is, the dialogue is terminated ; defaults (underlined) are taken or the parameters 
are ignored by SDAID. 

Table B-10. The parameters required to initialize SDAID event tracing. 
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// JOB SDTRACE 
//EXECSDAID 



4C53I TOD IN ERROR STATE 



4C54I TOD NOT OPERATIONAL 



Select size of SD area 



Enter n 
(a value) 



Press 
END 



4C70E DUPLICATE REQUEST FOR PDAID 
AND/OR SDAID 



Device X'cuu' must 
be a line printer 




SDAIDS 
Initializing SDAID, part 1 of 6 



§/Vo operator response is required to 
ieither of these messages if they are 
printed. The time stamp on SDAID out- 
iput will be zero. 



^Maximum area you may specify is 999k. 
\lf n is an add integer, the value is 
^incremented to the next even number. 



I This message is issued if SDAID has 
Ibeen initiated and not terminated before 
la second request to initiate SDAID is made. 
%The duplicate, or second request for 
ySDAID is automatically canceled. (This 
^message is also printed if a request to run 
la PDAID core-wrap output in an alter- 
nate area is made while SDAID is active . 



4C56E INSUFFICIENT SDAIDSPACE 
REALLOCATE 



Select a device 



Enter 

X'cuu' and 

GO and press END 



Enter 
GO 



Enter 
X'cuu' 



and press END] and press END 



Press 
END 



Use device 
X'cuu' for 
output 



Use device 
X'OOE' for 
output 



Use device 
X'cuu' for 
output 



If this message is printed, the SDAID job 
is terminated. Before re-initializing 
SDAIDS you must decrease the size of 
real partitions, thus increasing the size 
of the main page pool for the SD area. 



Use device 
X'OOE' for 
output 



1 



To part 2 



To part 2 
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Initializing SDAID, part 2 of 6 



From part 1 



From part 1 





4C60D STOP ON EVENT = 



Enter GO 
and press 
END 



Enter YES 

and GO 

and press END 



Enter YES 
and Press 
END 



Press 
END 



No stop 
on event 



Stop 
on event 



Stop 
on event 



No stop 
on event 



4C61D EVENT LIMITS = 



Enter GO 
and press 
END 



Enter GO and 
press END 



Specify event limits and 

~~~ I 

or 



Press 
END 



Trace events 
across all of 
virtual storage 



Trace events 
between limits 
specified 



Press 
END 



Trace events 
between limits 
specified 



Trace events 
across all of 
virtual storage 



Refer to Table B-6-A for a 
description of SDAID output 
classes. 

(FASTREC,GO generates the 
default of PGMCHK). Output 
class for the events PGMCHK, 
PAGE NO, and PAGEHDL is 
predetermined. Refer to 
Table B-6-B 



4C59D OUTCL = 




Enter GO 
and press 
END 



Specify an output class and 



Enter GO and 
press END 



T 

or 

_L 



Press 
END 



Use output 
class specified 



Take default 
output class of 
PSW(01) 



Press 
END 



Use output 
class specified 



Take default 
output class of 
PSW (01 ) 



To part 3 



To part 3 
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From part 2 



From part 2 



BR = Successful Branch Trace 




SDAIDS 
Initializing SDAID, part 3 of 6 



IF = Instruction Fetch Trace 




To part 4 



To part 4 
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SDAIDS 

Initializing SDAID, part 4 of 6 



From part 3 



From part 3 




4C64D EVENT SA = 



Enter GO 
and press 
END 



SA = Storage Alter Trace 



Enter YES and 



Enter GO and 
press END 



or 



Press 
END 



No SA trace 



Trace SA 
events 



Press 
END 



Trace SA 
events 



No SA trace 



4C65D EVENT GA = 



Enter GO 
and press 
END 



GA = General Purpose Register Trace 



Specify GPR(s) to be traced, (in hex) 



Enter GO and 
press END 



Press 
END 



No GPR trace 



Trace G PR (s) 
specified 




Press 
END 



Trace GPR (s) 
specified 



No GPR trace 




To part 5 



To part 5 
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From part 4 



From part 4 





SDAIDS 
Initializing SDAID, part 5 of 6 



4C66D EVENT TE = 



Enter GO 
and press 
END 



TE = Page Translation 
Exception Trace 



Enter YES and 



Enter GO and 
press END 



Press 
END 



No TE trace 



Trace TE 
events 



Trace TE 
events 




4C67D EVENT PGMCHK= 



Enter GO 
and press 
END 



Enter NO and 



Enter GO and I Press 

press END °. r END 



Trace 
PGMCHK(s) 



Do not trace 
PGMCHK(s) 



PGMCHK = Program check trace 




Do not trace 
PGMCHK(s) 






To part 6 



To part 6 
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Initializing SDAID, part 6 of 6 



From part 5 



From part 5 



4C68D EVENT PAGENQ = 



Enter GO 
and press 
END 



PAGEISIQ = Trace of page requests 
as they are placed in the page queue 



Enter YES and 



Enter GO and 
Press END 



Press 
END 



No PAGENQ 
trace 



Trace 
PAGENQ(s) 



PAGEHDL = Trace of pages as they 
are allocated to a frame in the real 
address area — page request is 
removed from the page queue. 



_J 



Press 
END 



Trace 
PAGENQ(s) 



No PAGENQ 
trace 



*J 



4C69D EVENT PAGEHDL = 



Enter YES 
and press 
END 



No PAGEHDL 
trace 



Press 
END 



Trace 
PAGEHDL 



No PAGE- 
HDL trace 



SDAID initializing output parts 1 and 2 are printed at this 
point during the initialization. The example opposite 
shows and explains the meaning of the initializing output. 
Retain this output if SDAID parameter changes are 
intended after initialization. 



4C57E SDAID SUCCESSFULLY INITIATED SDAREA=XXXXK 
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The Label Information Cylinder 



Library Display Programs and Utilities 

LSERV 



The label information cylinder contains standard and user label information for 
background and foreground partitions. 

19 tracks on the 3330/3333, 12 on the 3340, or 20 on the 2314/2319 are allocated 
to the label information cylinder. 

The purpose of the label cylinder is to enable label information to be placed in the 
label save areas during program execution. 

Job control stores label information, which is contained in the input job stream, 
on the label cylinder. 

During program execution, label information on the label cylinder is used by the 
OPEN and CLOSE routines. 



SAMPLE JOB STREAM 

// JOB CATALOG USER PROGRAM 
// OPTION CATAL 

[Object module preceded 1 
by PHASE and INCLUDEj 



User 
Phase 



/* 

// LBLTYP NSD (01) 

//EXECLNKEDT 

/& 

// JOB EXECUTE USER PROGRAM 

//DLBL 

// EXTENT 



//DLBL 

// EXTENT 

//TLBL 

// ASSGN 

//ASSGN 

//ASSGN 

// EXEC USER 

/& 



File 1 (Seq. Disk) — 

File 2 (Nonseq. Disk) 

File 3 (Labeled Tape) 
File 1 
File 2 
File 3 




SYSRES 



Label 

Information 

Cylinder 



Sequence of Events 

1 LBLTYP reserves label area in virtual storage 
for longest label block 

2 Link edit and catalog user phase to core 
image library 

3 Write label information to label cylinder 

4 Assign user files 

5 Bring program into virtual storage and process 
OPEN/CLOSE 

a. Bring label storage data into virtual storage 

b. Bring file labels into virtual storage 

c. Compare input, create new output labels 



An overview showing how DOS/VS uses 
the label information cylinder. 



Supervisor 



Seq. 
Disk 



Transient Area 



Label Area 
"*" Nonseq. Disk and Tape 



Background Partition 
USER Program 

Open all 3 

Close all 3 



Virtual 
Storage 
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Library Display Programs and Utilities 
LSERV 



NO. 




nOMPniMFNT 


STARTING DISK ADDRESS 


NUMBER 
OF TRACKS 
(Allocation) 


R = REQUIRED 




BB 


CC 


HH 


R 


= OPTIONAL 


1 


IPL Bootstrap Record 1 ($$A$IPL1) 


00 


00 


00 


1 


1 


R 


IPL Bootstrap Record 2 ($$A$IPI_1) 


00 


00 


00 


2 


R 


Volume Label 


00 


00 


00 


3 


R 


User Volume Label 


00 


00 


00 


4 


O 


2 


System 
Directory 


Record 1 


00 


00 


01 


1 


1 


R 
R 
R 
R 


Record 2 


00 


00 


01 


2 


Record 3 


00 


00 


01 


3 


Record 4 


00 


00 


01 


4 


IPL Retrieval Program ($$A$IPL2) 


00 


00 


01 


5 


R 


3 3 


Core Image Library Directory 


00 


00 


02 




* 


R 


4 


Core Image Library 


00 


End of CI Directory 




* 


R 


X | Y + 1 


5 


Relocatable Library Directory 


00 


End of CI Directory 




* 


O 


Z + 1 


00 


6 


Relocatable Library 


00 


End of RL Directory 




* 


O 


X 


Y + 1 


7 


Source Statement Library Directory 


00 


End of RL Directory 




* 


O 


Z + 1 


00 


8 


Source Statement Library 


00 


End of SS Directory 




* 


O 


X 


Y + 1 


9 


Procedure Library Directory 


00 


End of SS Directory 




* 


O 


Z + 1 | 00 


10 


Procedure Library 


00 


End of PL Directory 




* 


O 


X 


Y + 1 


11 




00 


End of P Library 




* 


O 


Label Information Cylinder 


Z + 1 




00 



'Allocation Dependent On User Requirements 
X = Ending CC of the Preceeding Directory 
Y = Ending HH of the Preceeding Directory 
Z = Ending CC of the Preceeding Library 

The location of the label information cylinder on the SYSRES extent 
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Under certain circumstances knowing the contents of libraries can be helpful 
during program debugging. The library display programs DSERV, CSERV, PSERV, 
SSERV, and RSERV enable you to print an image of: 

• Any library directory 

• Any library 

• Any program in any library 

• Any phase in any library. 

When using DSERV, a System Status Report is always printed before the specified 
directory. A private status report is also printed when private libraries are used 
with the system. 

An example of a system status report is shown in two examples at the end of the 
section describing the Linkage Editor Map (E-4 of this manual). 



When and how to use 

Control statements required to execute the library display programs are shown in 
the next two tables. 

The following list gives some examples of when to use the various library display 
programs: 

1. The operator action given under the appropriate message inDOS/VS Messages 
indicate when to execute DSERV. 

For example, under the message: 
1C33A PROGRAM NOT FOUND 

When error message instructions include a library display, enter cards that 
correspond to the library and type of display. Be sure to substitute the actual 
program module, book, sublibrary or phase name for the words phase 1 , module 1 , 
book 1 , sublib 1 , or prog 1 . 

Note: If you assign a private library and display that type of library, only the private 
library will be displayed. To obtain a display of the system library, the private 
library must be unassigned. 

Additional information on the display program is found inDOS/VS System 
Control Statements. 

Further recommendations as to when to use the library display programs are given 
after the two tables following. 



Library Display Programs and Utilities 

LIBRARY DISPLAY 
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Library Display Programs and Utilities 



LIBRARY 
DISPLAY 



Control cards required to execute the Library display programs 



Unit 


Element 


Control Statements Required 


Core Image 
Library 


Phase 


// JOB jobname 
//EXECCSERV 

DSPLY phasel [,phase2,...] 

/* 
/& 


Program 


// JOB jobname 
// EXECCSERV 

DSPLY prog1.ALL[,prog2.ALL,...] 

/* 

/& 


Library 


// JOB jobname 
//EXECCSERV 
DSPLY ALL 

/* 
/& 


Directory 


Unsorted 
// JOB jobname 
//EXECDSERV 

DSPLY CD 

/* 
/& 


Sorted 
//JOB jobname 
//'EXECDSERV 

DSPLYS CD 

/* 
/& 


Relocatable 
Library 


Module 


// JOB jobname 
// EXEC RSERV 

DSPLY modulel [,module2,...] 

/* 
/& 


Program 


// JOB jobname 
// EXEC RSERV 

DSPLY progl .ALL[,prog2.ALL,...] 

/* 

/& 


Library 


// JOB jobname 
// EXEC RSERV 
DSPLY ALL 

/* 
/& 


Directory 


Unsorted 
// JOB jobname 
//EXECDSERV 

DSPLY RD 
/* 
/& 


Sorted 
//JOB jobname 
// EXEC DSERV 

DSPLYS RD 

/* 
/& 



Table C-2 Library Display Control Cards (Part 1 or 2) 

Note: To execute DSER V, SYSIN must be assigned to a card reader, a tape unit, or a disk drive. 
SYSLOG must be assigned to a 1052, 3210 or 3215 console printer, or for the Model 125 
it must be assigned to the CRT. 



if"' 
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MAP command 

The MAP command produces on SYSLOG a map of virtual storage areas allocated 
to programs. 

An example of the output produced on the console printer is shown below: 



Other Aids 

JOB CONTROL 

COMMANDS AND 

STATEMENTS 





F2 


map 














• 


F2 

F2 


AREA 


K- 


-REAL 


UPPER LIHIT 


K-VIRT 


UPPER LIMIT 


NAME 




F2 


SP 




92K 


94207 




262144 




• 


12 


BG 


V5A 


30K 


124927 


292K 


561151 


KENSLOOP 


F2 


F4 


14 


10K 


135167 


80K 


643071 






F2 


F3 


U3D 


10K 


145407 


80K 


724991 




• 


F2 


F2 


V2A 


14K 


159743 


100K 


827391 


NO NAME 


F2 


Fl 


11 


82K 


243711 


120K 


950271 






F2 


SVA 








96K 


1048575 




• 


F2 


VIS 








68K 


1048575 




F2 


PP 




18K 


262143 






£k5%kj 






SP = Supervisor, V = Virtual, PP = Main Page Pool, 1 = Inactive, SVA = Shared Virtual Area, R = Real, 
A = Active, D=Deactivated 

1 , 2, 3, 4, 5 = Partition Priority (1 = highest priority), VIS = Amount of SVA reserved by GETVIS 
parameter of the VSTAB system generation macro 


K-REAL 


gives the number of bytes allocated to the real partition or the number of bytes of the main page pool. The size 
is given in multiples of 2K. 


UPPER LIMIT 


shows the highest storage addresses in decimal of the respective real partition, of the supervisor, and of the main 
page pool. 


K-VIRT 


specifies the number of bytes allocated to the respective virtual partition. The size is given in multiples of 2K. 
This field is blank for the supervisor and for the main page pool. 


UPPER LIMIT 


contains the highest storage address in decimal of the respective virtual partition. For the supervisor, this field 
specifies the start address of the virtual address area. This field is blank for the main page pool. 


NAME 


contains the name of the job which is currently executing in the corresponding partition. This field is blank for 
the supervisor, SVA, VIS, and for the main page pool. When the listing shows NO NAME for the background, 
or when the name field is blank for a foreground partition, no program is being executed in that area. However, 
the name field for any partition contains NO NAME when no job control statement or command was entered, 
but the program is active. 



Note: If a program issues an SVC55, some page frames in the main page pool (PP) will also belong to that program. Therefore to calculate 

the total area in real storage occupied by that program, the MAP command should be issued before running it. The difference between 

the number of K in the PP before running the program, and the number of K during the execution of the program is the amount of K 

seized by the SVC55. 

This also applies when PDAID output mode is an alternate area or the SDAID is initiated. 

In this case, the area occupied by the PDAID or SDAID is printed during their initialization. 

Note: The output does not indicate storage temporarily added to the page pool as a result of using the SIZE parameter of the 
EXEC statement. 
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Other Aids 

JOB CONTROL 
COMMANDS AND 
STATEMENTS 



OPTION 

The OPTION statement specifies one or more of the Job Control options. The 
format of the OPTION statement is: 

JCS Format 

//OPTION option 1 (,option2,...) 

The options that can appear in the operand field follow. Selected options can be 
in any order. Options are reset to the standards established at system generation 
time upon encountering a JOB or a /& statement. 



DUMP 



Causes a dump of the registers and main storage to be output on 
SYSLST, if assigned, in the case of an abnormal program end. (S( 
A -2 in this section for a full description.) 



NODUMP Suppresses the DUMP option, if the latter was specified in the STDJC 
macro during system generation. 

LOG Causes the listing of columns 1-80 of all control statements on 

SYSLST. Control statements are not listed until a LOG option is 
encountered. Once a LOG option statement is read, logging continues 
from job-step to job-step until NO LOG option is encountered or until 
either the JOB or /& control statement is encountered. 

NO LOG Suppresses the listing of all valid control statements on SYSLST until 
a LOG option is encountered. If SYSLST is assigned, invalid 
statements and commands are listed. 

LIST Causes language translators to write the source module listing on 

SYSLST. In addition, it causes the Assembler to write the hexadecimal 
object module listing and causes the Assembler and the FORTRAN 
compiler to write a summary of all errors in the source program. All 
are written on SYSLST. 



NOLIST Suppresses the LIST option. 



PAUSE 

The PAUSE command causes a pause at the end of the current job step. The 
PAUSE Job Control statement causes a pause immediately after processing this 
statement. At the time, SYSLOG is unlocked for message input. END (on the 
Models 135 and 145) or ENTER (on the Model 125) causes processing to continue. 
The PAUSE statement or command always appear on SYSLOG. If a 3210 or 3215 
or video console display unit is not available, the PAUSE statement or command 
is ignored. 
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Hardware Error Recording and Recovery 

RDESUM EREP 

The RDESUM option provides a summary of information about system operation 
during a specified 1 to 30 day period. This summary is created by searching the 
history/RDE tape, mounted on SYS009, for IPL, EOD, MCAR, CCH, and unit 
check records, after which these records are edited and printed on SYSLST. The 
information provided by the RDESUM option includes: 

• The starting and ending dates of the report. 

• The date, time, reason, and subsystem responsibility for each IPL. 

• The average run time between IPL and EOD (or between two consecutive IPLs 
if the ROD command was not issued to create an EOD record) for the 
specified interval. If specified, the number of IPL records that occur in the 
cluster interval, (see note) 

• The subsystem responsibility and number of times a subsystem caused a 
System Recovery Incident (a recoverable error that may cause system 
degradation) or a System Incident (an unrecoverable error that caused 
system failure). 

• If the history/RDE tape contains no records within the specified dates, an 
error message is printed and the report is terminated. 

• IPL records are not counted in the reports of sub-systems SI (System 
Recovery Incidents) 

• If an IPL record with a reason code of UN, IE, IM, ME or DF is immediately 
preceeded on the tape by an SRI that occurred within 30 minutes of the 
IPL, the SRI may be reclassified as an SI. The SRI is reclassified if (1) the 
subsystem ID specified for the IPL is the same as the device type of the SRI, 
or (2) if the subsystem ID is unknown (00). 

• Multiple SRIs on the same device are counted as a single SRI until there is a 
ten minute interval without an incident or an IPL record. 

• If an SI occurs within ten minutes of the IPL record following an SI, the SI is 
counted as a multiple occurrence of the first SI regardless of the subsystem 
involved. Intervening SRIs are ignored. 

• If 16 sequence errors occur on the history/RDE tape, RDESUM is 
terminated; if fewer than 16 sequence errors occur, the out-of-sequence 
records are ignored. 

Note: Clustering is the process of searching for multiple IPL records that have 
occurred within a specified number of minutes. Clustering can be used to detect 
multiple false starts that may distort other information provided by RDESUM. 

RDESUM is executed when the appropriate option card is encountered. The control 
information, including the start date for the report, the end date, the clustering 
interval if clustering is desired, and the company name, is entered once the 
EREPRDE phase is in main storage. The control information is entered in response 
to prompter messages. 

RDESUM does not summarize across multiple volumes of a history/RDE file. If 
EOF is encountered on the input tape, RDESUM goes to EOJ and the report 
printed reflects the information available from the start date to the last record 
on the tape. There may be some inaccuracy in the average run time per IPL 
(because RDESUM does not know when the EOD or next IPL record will occur, 
it uses the time of the last error record to compute the IPL period), but no other 
information is lost. 

RDESUM can be executed again for the next volume in the history/RDE file to 
obtain the remainder of the information for the desired reporting period. The 
previously specified period may be used on the subsequent volume because 
RDESUM starts with the first record on the tape if the specified start date is 
earlier than the date of the first record. 
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E R EP The following rules govern the method for summarizing RDE information: 

• If the history/RDE tape does not contain information for a portion of the 
required time period, only those dates on the tape that fall within the time 
period are processed. The actual dates processed are reflected on the 
summary listing. 

• If the starting date is defaulted, the first record on the tape is used to start 
the report. The report is stopped with the specified end date or, if that date 
is more than 30 days from the date of the first record processed, the 
thirtieth day processed. 

• If the end date is defaulted, the report is stopped with the last date on the 
tape or, if that date is more than 30 days from the starting date, on the 
thirtieth day processed. 

HIST or HIST with Operands 

This option copies the data on the SYSREC file to the history/RDE tapes. All 
records on the tape(s) appear in chronological order. If an unrecoverable I/O 
error occurs while a record is being read from the SYSREC file, the record is 
ignored and processing continues with the next sequential record. If the data fills 
the complete tape, the message 

3E15A TAPE FULL, MOUNT NEW TAPE 

is printed on SYSLOG. The operator must mount a new tape and press END to 
continue processing, or he may respond with CANCEL and press END to cancel 
the HIST option. 

The tape must be mounted on SYS009, which must be assigned to a tape drive 
before EREP is executed. The tape contains standard labels that are checked 
before the history/RDE tape is written. If the wrong tape is mounted, the message 

3E31A WRONG TAPE, MOUNT CORRECT TAPE 

is printed on SYSLOG, Mount the correct tape and press END to continue 
processing, or respond CANCEL END to cancel the HIST option. When the HIST 
option is specified, the CLEAR option is forced. The SYSREC file is cleared 
after the history/RDE tape has been created or updated, thus preventing 
redundant data from being transferred to the history/RDE tape the next time the 
HIST option is executed. 

HIST,NEW,[,2] : This option causes EREP to create a history file on the tape unit 
assigned to SYS009. If 2 is also specified, a second history file is created on the 
same tape unit for RDE data. The data contained on both tapes is identical. The 
tape(s) contain the contents of the SYSREC file. The SYSREC file is cleared after 
all options have been executed. 

HIST.UPNEW: This option causes the tape file mounted on SYS009 (either 
history or RDE) to be updated, after which a new tape file is created. If UPNEW 
is specified, TLBL information for creation and updating must be included in the 
job stream. The SYSREC file is cleared when all options have been executed. 
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TES or TES with Operands E R E P 

The TES options provide for the editing and printing of the tape error records on 
SYSREC and the summarizing of tape data found on either SYSREC or the history 
file. 

To enable this option to be used a work or scratch tape must be mounted on a tape 
unit assigned to SYS008. This option can also select tape error data from the 
SYSREC file and create a TES history tape with the same format as the previously 
supported ESTV tape file. All records on the tape appear in chronological order. If 
an unrecoverable I/O error occurs while reading a record from the SYSREC file, 
the record is ignored and processing continues with the next sequential record. If 
the data fills the complete tape, the message 

3E15A TAPE FULL, MOUNT NEW TAPE 

is printed on SYSLOG. The operator must mount a new tape and press END, or he 
may respond CANCEL END; the latter response causes tape updating to be 
discontinued, but TES records are still printed. 

The tape must be mounted on SYS009, which must be assigned to a tape drive 
before EREP is executed. The tape contains standard labels that are checked 
before the history /RDE tape is written. If the wrong tape is mounted, the message 

3E31A WRONG TAPE, MOUNT CORRECT TAPE 

is printed on SYSLOG. Mount the correct tape and press END to continue processing, 
or respond CANCEL END to cancel the TES option. The history/RDE tape and 
TES history tape should be created or updated during the same EREP run. If the 
HIST option is specified without the TES option, the SYSREC File is cleared after 
HIST has been executed, and the TES data is lost. If you wish to maintain both 
^ these history tapes and the TES and HIST options are not specified together in 

one EREP run, the data on the TES history file may be redundant or lost. 

TES,NEW: This causes EREP to create a TES history file on the tape unit 

assigned to SYS007. The tape file contains tape error data from the SYSREC file. 

The tape error data on the tape has the same record format as the previously 

supported ESTV tape file. Use ESTVUT utility program to print this tape file. 

TES: EREP updates the TES history tape on SYS007. 

TES,NOTAPE,PRINT: Causes the tape data on SYSREC to be edited and printed 

into SYSLST. Data is printed in the detail tape unit format. 

TES,PRINT,NEW: A new TES history tape is created on SYS007, after which the 

tape error data on SYSREC is edited and printed on SYSLST. The data is printed 

in the detail tape unit format. 

TES,PRINT: The TES history tape, which is mounted on SYS007, is updated. 

The tape error data on SYSREC is then edited and printed on SYSLST in the 

detail tape unit format. 

TES,NOTAPE,SUM: The tape error data on SYSREC is summarized by tape drive. 

TES,NOTAPE,PR I NT,SUM : The tape error data on SYSREC is edited and printed 

on SYSLST in the detail tape unit format. Then the tape error data on SYSREC is 

summarized by channel and unit and printed on SYSLST. 

TES,SUM,VOL: The TES history tape on SYS007 is updated. Afterwards the 

tape error data found on SYSREC is summarized by volume serial number. 

TES,PRINT,VOL: The TES history tape mounted on SYS007 is updated. The 

tape error data on SYSREC is edited and printeri on SYSLST in the detail volume 

I serial number format. SYS008 is used as a work tape and the detail records are 
printed in sequence by volume serial number. 




Four examples of processing tape error statistics using EREP are given in 
Aonendix O. 



Appendix 6 



Serviceability Aids. 2 .2 1 5 



Hardware Error Recording and Recovery 

EREP EREP History Tapes 



There are three types of EREP history tapes: the History tape, the RDE tape, and 
the TES history tape. The History and RDE tapes are created and updated from the 
SYSREC file and contain all the record types found on the SYSREC file. The TES 
history tape is also created from the SYSREC file, but contains only tape error 
records. If your installation has the History/RDE tapes and a TES history tape, you 
should create (or update) all the history tapes in the same run. If this procedure is 
not followed, the TES history tape may have redundant or missing data. 

Retain the History and TES history tapes for those persons who work on problem 
determination. The History tape can be used as input for certain online test 
programs of OLTEP. (See the OLTEP manual.) The TES history tape can be printed 
with the ESTVUT utility program. Retain the RDE tape; it will be used by IBM. 

History/RDE Tape 

The History/RDE tape is created and updated using the EREP history option. This 
tape contains RDE data only if ERRLOG=RDE is specified at system generation. A 
magnetic tape unit assigned to SYS007 must be used for this function. EREPNEW 
must be the filename that is used when a tape is created, and EREPUP when a tape 
is updated (both TLBL cards must be included for UPNEW). When the tape becomes 
full or when a second tape must be mounted, the operator is notified via SYS LOG. 

Note: If EREP is link-edited as a self-relocating program, an LBLTYP card is 
needed when EREP builds a history /RDE tape. 



TES History Tape 

The TES history tape is created and updated using the EREP TES options. A 
magnetic tape unit assigned to SYS007 must be used for this function. The filename 
of the tape file must be TAPEIN when the file is created and the file is updated. 



Creating the History Tapes 

You can create a history tape only if DOS/VS has recorded errors on SYSREC. 
The EREP program allows you to create or update the three types of history tapes, 
three types of history tapes. 

You can create the History/RDE tape by specifying OPTION HIST, NEW, and 
update it by specifying OPTION HIST. 

If a System/370 RDE tape is to be processed, the message 3E16A is printed on 
SYSLOG after the History tape is written. This message instructs you to replace 
the History tape reel with the RDE tape reel and then respond to the message. A 
response of END will cause the RDE tape to be processed and response of CANCEL 
END will cancel only the HIST option. Any other response will cause the system 
to reissue message 3E16A. 

In addition, you can create a TES history tape, which contains only tape error 
records. If you want to maintain a TES history tape, create (or update) it in the 
same EREP run in which you create (or update) the History/RDE tape. You can 
create the TES history tape by specifying OPTION TES,TAPE,NEW, and update 
it by specifying OPTION TES, TAPE. 



if 
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DISPLAY FRAMES 
(MODEL 158 ONLY) 





5 . Scan the frame for any characters that flash on and off beside an entry displayed. 
^ For example, Z-BUS 614250 indicates that the hardware failure is caused by a 

* failure in the Z-BUS. 

If a hardware failure is indicated, press COPY to obtain a hard copy of that 
frame and make a note on the hard copy about the error. (Characters that 
indicate an error are not copied by the system.) 

6. Press the key marked f on the keyboard, as illustrated below. 
The next display frame will be displayed. 



CNCL 


1 


< 

2 


3 


4 


% 
5 


6 


> 

7 


* 

8 


( 
9 


) 



+ 
& 


* 


START 


STOP 




H 


Q 


W 


E 


R 


T 


Y 


U 


I 


P 


@ 


r 




MODE 
SEL 


IRPT 




REQ 


LOCK 


A 


S 


D 


F 


G 


H 


J 


K 


i 
L $ 


i 




« t 


1 


1 






COP\ 


SHIFT 


Z 


X 


C 


V 


B 


N 


M 


— I 


■? 

/ 


SHIFT 












KEYBD 
RESET 








ENTER 







7. Repeat steps 5 and 6 until all display frames have been scanned and hard copies 
made of those containing information about the failure. 

8. Press CANL to obtain the program frame. 



When to use 

1. After recognizing a hardware failure as shown in the example above. 

2. On advice from your IBM CE. 
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OLTEP 



Note: Not applicable to the 
Models 115 and 125 using 
a supervisor that does 
not support the RMSR 
function. 



IBM provides a set of device test programs that run under control of DOS/VS. 
These test programs and the online test executive program form the online test 
system. The Online Test Executive program (OLTEP) is an interface between the 
system and the online test programs (OLTs) and communicates with the operator 
during the running of tests. 

Some uses: 

• Diagnosing I/O errors 

• Verifying I/O device repairs and engineering changes 

• Checking I/O devices. 

Some features: 

• Multiple device testing 

• Data security 

• Data protection 

• No re-IPL time required 

• Prompting 

• ASCII data conversion 

* ■•■• Accessing of error recording information 

• CDS Equate function. 



OLT 



OLTEP 



Printer 



OPERATOR 



Supervisor 



Card 
Read/Punch 




■NK 



Teleprocessing 




OLTEP-System Relationship 
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From part 1 of this chart 



Wait State 
CHART 03, PART 2 




AR 1I60A READY FOR COMMUNICATIONS. 



Yes 



Yes 



See D- 1 F f or Models 1 35, 1 45, 1 55-1 1 
and D-5-F for Models 1 1 5, 1 25 
and D-6-F for Model 1 58 



Check that the last JCL 
assigning SYSLOG was a 
statement and not a 
command 



No 



No 



Dump or display low 
address storage. Use 
ALTER /DISPLAY 



Compare the contents of 
bytes 0-3 of low address 
storage with the list of 
wait state coded messages 
shown in table 3.3 on 
page 3.4 




Comparison 
met 

No 

Byte 1 
contains E6 

No 



Yes 



Yes 








Yes 


^*^ Byte 1 




* 


^ contains C1 
^^^or C4 






JTno 






^"""^ Byte 1 
■^^ contains E2 








|Yes 






B 


Continued debugging using 
the flowchart shown in 
Section 2,E-3-F. 


To 



No 



SOFT WAIT 



To part 4 of this chart 



D 



To part 3 of this chart 
Debugging for Operators. 
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Wait State 

CHART 03, PART 3 



From part 2 of this chart 



Issue the MAP command. 
Refer to Section 2, E-1. 



Make each I/O device 
NOT READY, then 
READY in turn, checking 
for any l/Q activity as 
this action is carried out. 



No 




Yes 




4 



No 



Yes 



Contact terminal (s) and 
request data to be 
entered 



Yes 




If an interrupt occurs, the CPU 
is taken out of the wait state,; and 
processing is started under control 
of the program being executed. 



No 



(f 



To part 4 of this chart 
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Unintended Loop 

CHART 04, PART 6 



From part 5 of this chart. 



At this stage, if only one job has not reached 
EOJ, it is possible that this job is causing the 
loop. Check estimated job run time with 
programmer or on program run sheet 




Yes 



From part 2 of this chart 



No 



More than one job still 
running 




Let system continue 
processing. Programmer 
must immediately 
analyze the problem 



Yes 



Execute a stand-alone dump 
as recommended in Section 2, 
A-3-F. On completion of the 
dump, re-IPL and obtain a dump 
or copy of the page data set as 
described in Section 2, C-6. 



Turn to Section 4, 
Chart 01, Part 2 



Save the following for the 
programmer: 

• SYSLOG output 

• Line printer output 

• Job stream 

• I/O files/volumes 

• Loop trace (instruction 
step or SDAID output) 

• MAP, if applicable. 



Re-IPL: initiate 
different jobs 



Loop is probably caused 
by this job 



Trace loop either by 
instruction step (See 
note 1 ) or by using SDAID 
routines B-10-F (See 
note 2) 



From part 2 or 4 of this chart 



Note 1: 

See D-4-F for Models 135, 145, 155-11 
and D-5-F for Models 1 15, 125 
and D-6-F for Model 158 

Note 2: 

SDAID should be used 
only by system programmers 
or by IBM CE/SE. 
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Obviously Incorrect Output 
CHART 05 



Start 



The identity of the partition using the device: 

This can be deduced from information given on 

the job run sheet, or the device ASSGN statements 

and commands issued on SYSLOG and SYSLST. 

An alternative method is to make the device producing 

incorrect output NOT READY. This will cause a 

device error recovery message to be issued on SYSLOG. 

Determine the partition using the device from the 
message printed on SYSLOG as a result of this action. 



BG 0P08A INTERV REQSYS008= 383 



Partition identity 



I/O Device Address 



If SYSLST for the partition to be dumped is not 
assigned to a line printer, use the line printer 
assigned as SYSLST on another partition. 
For example, DUMP F2S(BG). 
Note: This may produce dump output from the 
partition being dumped, interspersed with 
output from the program using the line printer. 



A System dump may be issued on the device assigned to 

SYSLST for the partition being canceled. 

(The System dump is described in Section 2, A-2.) 













W possible, contact the programmer 
to establish the expected output, 
and identify which job or partition 
is using the device that is 
producing the incorrect output 














Make the device producing 
incorrect output NOT READY 














Press REQUEST and wait for 
message 0P60D, then enter 
IGNORE 












AR 1I60A READY FOR COMMUNICATIONS. 












Respond to the AR message 

by issuing the DUMP command 

to dump the partition and the 

supervisor, for example, DUMP F2S 

SYSLST must be assigned to a 

line printer. 

Refer to Section 2, A-1 














Cancel the job in the partition 
producing the incorrect output 














Save the following information 
for the programmer(s). 

• SYSLOG output 

• Line printer output, including 
all dump output 

• Job stream 

• I/O files/volumes 





,4 



V 
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Start 



Program Canceled 

CHART 06 



An informative message 
is issued on SYS LOG 
or SYSLST, or both 



0P731 JOB DEBUGEX8 CANCELED DUE TO I/O ERROR 
0S071 PROBLEM PROGRAM PSW 031 0000000007 A02 



An example of a job cancellation 
message issued on SYSLST 



BG 0P24I C PROG CHECK SYSOO^OOD 

CCSW=001 000022800200000 CCB=007A0E 

SNS-0000000000000000000000000000000000000000000000001 
BG 0P73IJOB DEBUGEX8 CANCELED DUE TO I/O ERROR 



An example of a job cancellation 
message issued on SYS LOG 



A system dump is issued 
to the device assigned as 
SYSLST 




A system dump is issued to SYSLST under the 
following conditions 

1 . The supervisor in use supports the OPTION DUMP, 
which is not overruled by the job control statement 
// OPTION NODUMP in the job stream. 

2. The job control statement // OPTION DUMP is 
included in the job stream. 

For a complete description of the system dump, refer 
to Section 2, A - 2. 



No 



Yes 



Dump the disk extent, or 
tape assigned as SYSLST 
to obtain a printed dump 



Execute the 
MAP cmmand 
( refer section 
2, E-i ) 



Save the following information 
for the programmer: 

• SYSLOG output 

• Line printer output, including 
any error messages and the 
system dump 

• Job stream 
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For your notes 



c 
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Errors during IPL 

CHART 02, PART 1 OF 1 



Check 



— Check 1 

Supervisor listing 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



If the IPL procedure can not be completed 
and the supervisor in use has never been used 
on the system, check the supervisor assembly 
listing for flagged statements. Also note in 
the listing the options supported by the 
supervisor. 

Check that the hardware is present in the 
system for options supported by the super- 
visor that require hardware support. 

Also check that the supervisor is generated 
to support hardware options that are present 
on the system. 



If the cause of the error can not be isolated, 
inform IBM and have the following informa- 
tion available: 

• The supervisor listing 

• The stand-alone dump output, including 
the dump of the low address storage 

• The SYSRES pack used when the error 
occurred 

• Any notes about actions taken during error 
analysis both on and offline. 
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Hard Wait Message Codes 
SUPPORT FOR CHART 03 



BYTEO 


BYTE 1 


BYTE 2 


BYTE 3 


EXPLANATION 


MCH/CCH/IPL Hard Wait Codes placed 


in low address storage 


x'cr 


X'E2'(2) 


A, l,S(1) 


Not used 


Irrecoverable machine check. 


X'C2' 


X'E2'(2) 


Not used 


Not used 


Irrecoverable channel failure during RMS fetch. 


X'C3' 


X'E2'(2) 


A, I, S(1) 


Not used 


Channel failure on SYSLOG when RMS message scheduled. 


X'C4' 


X'E2'(2) 


A, I, SO) 


Not used 


No ECSW stored 


X'C5' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure: ERPBs exhausted. 


X'C6' 


X'E2'(2) 


A, I, S(T) 


Not used 


Channel failure; two channels damaged or a damaged channel situation occurred while RMS 
was executing an I/O operation. 


X'C7' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; system reset was presented by a channel. 


X'C8' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; system codes in ECSW are invalid. 


X'C9' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; channel address invalid. 


X'DV 


X'E2'(2) 


A, I, SO) 


Not used 


Irrecoverable channel failure on SYSVIS. 


X'07' 


X'E6' 


Channel 


Unit or 
X'00' 


IPL I/O error or equipment malfunction; condition code 2 during STIDC instruction. 
Channel and unit indicate whether device in error is SYSRES or communication device. 
When byte 3 = X'00', byte 2 indicates the channel for which STIDC instruction was 
issued. Re-I PL system. 


SDAID Hard Wait Code 


X'61' 


X'E6'(3) 


Channel 


Unit 


Another device is running in burst mode on same channel as SDAID output device. 
Re-IPL system. 


SDAID Soft Wait Code 


X'62 


X'C5' 


Not used 


Not used 


SDAID output device became unready, Make printer ready and press the EXTERNAL 
INTERRUPT key. 


X'00' 


X'OO'O) 


X'00' 


X'00' 


SDAID Stop on Event. Press EXTERNAL INTERRUPT key to 
continue operations. 


The foil 


awing Hard Wait Codes are plac 


3d in general register 1 1 X'B' as well as in low address storage. 


X'00' 


X'00' 


X'OF' 


X'FF' 


Program Check in Supervisor. 


X'00' 


X'00' 


X'OF' 


X'FE' 


I/O error during fetch from System CI L. 


X'00' 


X'00' 


X'OF' 


X'FD' 


Channel Failure if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'00' 


X'00' 


X'OF' 


X'FC 


Machine Check if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'00' 


X'00' 


X'OF' 


X'FB' 


Page Fault in Supervisor routine with identifier RID X'00' 


X'00' 


X'00' 


X'OF' 


X'FA' 


Translation Specification Exception 


X'00' 


X'00' 


X'OF' 


X'F9' 


Error on Paging I/O. 


X'00' 


X'00' 


X'OF' 


X'F8' 


CRT phase not found. 


X'00' 


X'00' 


X'OF' 


X'F7' 


No copy blocks available for BTAM appendage I/O request 


X'00' 


X'00' 


X'OF' 


X'F6' 


$MAINDR canceled during system CI L update. 

If this occurs, the system CIL is only partially updated and must be restored before use. 
This hard wait condition can also occur if the FETCH QUEUE BIT (FCHQ) is set in the 
linkage control byte in the partition communication region owned by the 










terminating partition. 


Device E 


rror Recovery Soft Wait Codes 


placed in low address storage. 


X'08'to 


X'd'or 


Channel 


Unit 


Error recovery messages. Refer to OP messages in DOS/VS Messages. 



No tes: 1.A(X'C1')=S YSREC recording unsuccessful. 

I (X'C9') = SYSREC recording incomplete. 

S (X'E2') = SYSREC recording successful. 
2.S(X'E2') = Run SE REP. 
3. SDAID wait states are identified by X'EEEE' 

in the address part of the wait PSW. 

Refer to Section 2-E-3 for a list of IPL error message codes and a more detailed description of wait states. 



C 
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Incorrect Output detected during Program execution 

CHART 08, PART 1 OF 5 



Check 



Check 1- 

Type of program 
producing the 
incorrect output 



Method of Analysis 



-c 



Userwritten? 



IBM-supplied program? 

Assembly language 

High level language compiler (RPG II, 

FORTRAN, etc.) 

IBM library program (DSERV, SORT/ 

MERGE) etc. 



Recommendations to Aid 
Further Problem Analysis 



Proceed to check 2. 



Inform IBM and have the following informa- 
tion available: 

• All output from the program 

• SYSLOG output 

• Job stream 

• Input files 

• Supervisor generation notes and level of 
release 

• Listing of the support for the failing 
program 

• Notes about system type and model, and 
any notes about system status and input/ 
output units used for the program. 



Check 2- 

Type of incorrect 
output 



Use any output from the program and 
messages printed during program execution 
to determine the type of/incorrect output 
according to the following categories: 



• Duplicate (identical lines printed). 



• Lack of (missing data printed). 



• Too much or unexpected (more data printed 
than expected). 



Use the program listing and analyze the 
coding, checking for: 

• Unnecessary program loops in input/ 
output routines 

• Routines not being entered or completed 

• Overlaid input/output areas. 

If necessary, re-run the program using 
SDAID IF, SA, and GA trace functions. 
Specify event limits that will adequately 
cover routines that prepare output areas. 
(Refer to section 2-B-10.) 
Re-analyze the output from the re-run. 
If the error can not be isolated proceed to 
check 3. 



-Check 3 



System condition 
during program 
execution 



Were there any abnormal interruptions in 
computer operations during execution of the 
program? 



Yes 



No 



Were any abnormalities observed in system 
actions or response to messages by the 
operator during program execution? 



Yes 



No 



Analyze the possible effects of any interrup- 
tion, and re-run the program ensuring no 
interruptions. 



Re-run the program and note any unex- 
pected system actions. Ensure the correct 
response is given to messages issued. (Refer to 
the DOS/VS Messages manual). 
Use any notes made to analyze program logic. 
If necessary, re-run the program using with 
the SDAID IF trace to aid analysis of pro- 
gram logic. 
Check the input used for the program. 

Proceed to check 4. 
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Check Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Check 4 



Environment 



Was the program operating under POWER or 
POWER RJE? 



Yes 



No 



Turn to part 5 of this chart, check 1 3. 



Proceed to check 5. 



Check 5 



Job stream 




Check that the correct job stream was used for 
the program. This applies also to job streams 
cataloged on the procedure library. 
(Use PSERV to display the procedure 
library; refer to section 2-C-3.) 



If error isolated, make corrections as 
necessary and re-run the program. 

If error can not be isolated, proceed to 
check 6. 



Check 6 



Input used 



Isolate suspected areas on the input files 
by examining the output from the program. 
For example, a missing record in the 
output indicates the approximate area on 
the input file that may be in error. 



Check the labels and volume ID and extent 
information. Use LSERV and LVTOC, or 
for VSAM files use LISTCAT Access 
Method Services utility commands. 



A. Obtain a dump of suspected areas on the 
input files used. For VSAM files use the 
Access Method Services utility program 
PRINT command. (Refer to section 2-C). 

B. Check input/output file macro 
definitions in the program listing against 
characteristics of data on the input files. 
DTF (LIOCS), CCB (PIOCS) 

ACB, RPL, and GENCB (VSAM). 

Compare the output of the LSERV, LVTOC, 
and LISTCAT programs with DLBL/EXTENT, 
VOL ID, data in the job stream. 
If no errors can be found, proceed to check 7. 



( 
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Check 



Check 3 



Method of Analysis 



Program check 
occurred before 



Was a note of system activity and environment 
made when the identical program check 
occurred in any previous run of the program? 



Yes 



No 



Recommendations to 
aid further Analysis. 



Compare note made with the conditions and 
environment under which this program check 
occurred again. Proceed to check 4. 



Make note of the system environment and I/O 
units involved. Also note the I/O files in use. 
Proceed to check 4. 



Check 4 



Gather more system 
information 



Re-run the program with the PDAID F/L trace 
to trace phases used. Also use the DIAG 
parameter to trace SVCs issued by the POWER 
or POWER RJE SCP. (Refer to Appendix J). 



Re-analyze the problem using the output from 

the re-run and information obtained from your 

previous analysis of the problem. 

If the error can not be isolated, inform IBM 

and have the following information available: 

o Program output 

o SYSLOG output 

o Job stream 

o Supervisor listing 

o POWER or POWER RJE assembly listing 

listing and linkage editor map 
o Any notes made about system environment 
o I/O units used and system condition 
o PDAID output 
o POWER DIAG SVC trace output. 
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Section 4, Part 2 

CONTENTS 



1 . General organization of virtual storage 4.33 

2. Communication regions 4.34 

Partition Communication Regions (COMREGs) 4.35 

System Communication Region (SYSCOM) 4.42 

3. Supervisor I/O tables and information blocks 4.44 

LUB, NICL and FICL 4.46 

PUB and FOCL 4.48 

Device Type Codes 4.50 

PUBOWNERSHIP 4.53 

JIB, FAVP 4.54 

CHANQ, and FLPTR 4.56 

Channel Control Table and Channel Bucket 4.58 

Error recovery Block and ERRQ 4.60 

4. DOS/VS Input/Output Control System (IOCS) 4.62 

Using Physical IOCS and Logical IOCS 4.64 

Imperative and Declarative Macros 4.65 

VSAM file definition macros and control blocks 4.72 

5. Command control block (CCB) and channel programs (CCW) 4.77 

6. DOS/VS Supervisor calls (SVC) and their functions 4.84 

7. Program information block (PIB and PIB2) 4.88 

8. DOS/VS Cancel Codes 4.94 

9. General purpose register usage 4.96 

By DOS/VS 4.96 

For programmer use 4.96 

By JOB ACCOUNTING 4.97 

By POWER 4.97 $ 

By POWER RJE 4.97 1 

For sub-routine linkage 4.98 

10. User exit routine support 4.99 

IT (Interval Timer) 4.100 

AB (Abnormal Termination) 4. 1 02 

PHO (Page Fault Handling Overlap) 4.103 

PC (Program Check) 4.104 

OC (Operator Communications) 4.105 

11. Save areas 4.106 

Partition save areas 4. 1 06 

User exit routine save areas 4.109 

System save areas 4.1 10 

Save area for JOB ACCOUNTING 4.111 

12. Tables required by the PAGE MANAGEMENT routines 4.1 12 

The segment table 4.1 12 

The page table 4.1 1 3 

The page frame table and extension 4.1 14 

The boundary box 4.1 15 

Converting virtual addresses to real 4. 1 1 6 

Converting real addresses to virtual , . 4.1 18 

13. Channel program translation 4.120 

The IDAL block 4.122 

The CCB copy block 4.124 

The CCW copy block 4.126 

CCW/Translation Control Block 4.127 

Fix Information block 4.128 

Rules applicable for channel program translation 4.128 ^- 

Note: Contents and addresses shown in the illustrations are subject to change and are shown only as an aid to offline if 

debugging of DOS/VS. % - 

IBM will not be responsible for any system malfunction resulting from a change made by the user to any 
contents or addresses of the tables and blocks described. 
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PARTITION COMMUNICATION REGION (. 



Cont'd) 



Displacement 


Meaning 


(Dec) 


(Hex) 


60 


3C 


Binary disk address of the volume label area (label cylinder). 


62 
76 


Ml 
4CJ 


Addresses of FOCL, PUB, FAVP, JIB, TEB, FICL, NICLand LUB 
(See Figure 4.2) 


78 


4E 


Set to the value nn specified in the LINES= nn parameter of the STDJC macro. 


79 


4F 


The format of the system date contained within this field is determined by the IPL 
program from information supplied in the date convention bit (displacement 53). 
Bytes 85-87 contain the day count. 


88 


58 


Bytes reserved for use by LIOCS. Transient dump programs insert a key to indicate 
to the LIOCS end-of-volume routine, $$BCMT07, that it was called by a B-transient. 


90 


5A 


Address of the first part of the program information block (PIB) table. 


92 


5C 


ID number of the last checkpoint. Byte 92 is also the temporary indicator of file 
protected DASD. Bits 0-6 correspond to channels 0-6. A bit ON means DASDFP for 
that channel. Bit 7 indicates 2321 DASDFP support. Byte 93 is used at IPL time 
by PIOCS - Bit 0: 1 = 3330 file protection 
Bit 1:1= 3340 file protection 


94 


5E 


Job zone for Time of Day. If ZONE=EAST, value is positive; if ZONE=WEST, 
value is negative. 


96 


60 


Address of the disk information block (DIB) table for the partition. 


98 


62 


Reserved. 


100 


64 


Address for PC, IT, and OC option tables. 


104 


68 




106 
108 


6A 
6C 


Key of the program that has internal timer support. The key is the same as the 

PIK for the timer supported partition. If multiple partitions all have timer support it 

is initially X'0010' but may be changed to the PIK of another partition by the 

TIMER command. It is copied into all partition communications regions. If no 

partition has interval timer support, these bytes contain X'0000'. 

Reserved. 


110 


6E 


Logical Transient Key (LTK) contains the same value as the PIK (PID) (Displacement 

46) when the logical transient is requested. When the transient area is not in use, 

LTK is equal to zero. The SVC2 routine sets the LTK. (See Appendix B 

for a description of the LTK). 

The SVC1 1 routine resets the LTK, (only significant in BG communication reg.) 


112 


70 


Address of SYSPARM field. 


116 


74 


Address of Job Accounting partition table. 


120 


78 


Address of the Time of Day Clock common area. 


124 


7C 


Address of second part of program information block (PIB) table. 


126 


7E 


Address of PDTABB, table of DTF addresses for MICR support. 


128 


80 


Address of QTAM vector table (IJLQTTAD). 


132 


84 


Address of background communications region. 



Section 4, Chapter 2 

COMMUNICATION 
REGIONS 



Figure 4.3. Key to Communication Region displacement, part 4 of 6 
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PARTITION COMMUNICATION REGION (. . . Cont'd) 



Displacement 



(Dec) (Hex) 



134 



135 



136 
140 



141 



142 



143 



86 



87 



8C 



8D 



8E 



8F 



Meaning 



RMSR OPEN flags 



Option Indicator byte 

Bit 0: Reserved 

1: 1= EU interface active 

0= EU interface inactive 
2: 1= Teleprocessing request 

0= No teleprocessing request 
3: 1= Supervisor support for tape 

0= Supervisor does not support tape 
4: Reserved 
5: 1= RETAIN support generated 

0= RETAIN support not generated 
6: 1= Linkage to Channel En d Appendage Routine allowed 

0= Linkage to Channel End Appendage Routine not allowed 
7: 1= GETVIS function has been initiated 

0= GETVIS function has not been initiated. 

System Configuration byte 2 and RMSR Open Flag byte 

Bit 0: 1= PCI L supported 

0= PCI L not supported 
1 : TOD supported 
2: 1= PFIX macro supported 

0= PFIX macro not supported 
3: 1= Fetch $$OPEN by SJOBCTLJ 
4: 1= Fetch $$OPEN by SJOBCTLD 
5: 1= Fetch $$OPEN by SJOBCTLJ for WTM 
6: 1= QTAM supported 

0= QTAM not supported 
7: 1= RPS supported 0= RPS not supported 

Pointer to Option table in SYSCOM. Reserved for compatibility reasons. 

Standard Job Control Option byte 

BitO: 1= EDECK Standard Option 
1: 1= ALIGN Standard Option 
2-6: Not used 
7: 1 = ACANCEL standard 

Temporary Job Control Option byte 
Bit 0: 1= EDECK Temporary Option 
1: 1= ALIGN Temporary Option. 
2-5: Not used 
6:1 = SUBLIB = DF 

Temporary Option 
7:1 = ACANCEL 
Temporary Option 

Disk Configuration byte 
Bit 0-4: Not used 

5: 1 = 3340 supported 

= 3340 not supported 
6: 1= 3330 supported 

0= 3330 not supported 
7: Always 1; indicates 2311 and 2314/2319 supported. 

Catalogued Procedure Name. 



( 



Figure 4.3. Key to Communication Region displacement, part 5 of 6 
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Hex 
Dec 



A2 


A3 


A4 


A5 


A6 


A7 


BO 


B4 


B8 


162 


163 


164 


165 


166 


167 


176 


180 


184 


Pointer 


Pointer 


Pointer 


Pointer 


Pointer to 


Reserved 


Not 


Address 


Not 


to 


to 


to CRT 


to ERP 


PAGEIN 


9 X'00' 


Used 


of 


Used 


PMGR 


SUPVR 


Task 


Task 


Task block 






MVCFLD 




Task 


Task 


Block 


Block 












Block 


Block' 

















COMMUNICATION 
REGIONS 



Hex 


BC 


BE 


CO 


CB 


CC 


CE 


DO 


D4 


D8 


Dec 


188 


190 


192 


203 


204 


206 


208 


212 


216 




Not 


Not 


Reposi- 


Number of 


Length 


Number 


Address 


Address 


Address 




Used 


Used 


tioning 


Error 


of PUB 


of 


of 


of Page 


of Page 








information 


Queue 


Table 


Active 


Segment 


Frame 


Frame 








for 2560/ 


Entries 


in Bytes 


Partitions 


Table 


Table 


Table 








5425 ERP 












Extension 



Hex 
Dec 



DC 


E0 


E4 


E8 


EC 


F0 


F4 


F5 


F8 


FC 


100 


220 


224 


228 


232 


236 


240 


244 


245 


248 


252 


256 




Address 


Reserved 


Address 


Address 


Address of 


SVA 


Address 


Address of 


Address of 


Pointer to 


of 


of DPD 




of 


of End 


Fetch 


Flag 


of SVA 


System 


LDLin 


RPS Sector 


Boundary 
Box 


Table 




VIRTAD 
Routine 


of Real 
Storage 
(Fullword) 


table 


(See 
expansion) 




GETVISarea 


SVA 


Calculation 
Routine 



Figure 4.4 Format and contents of SYSCOM, part 2 of 2 



Dec 


Hex 


Description 


64 


40 


Reserved for RMS support on the Models 115 and 125 






X'80' 


RMSR for channel attached devices, tapes and TP devices 






X'40' 


Full RMS support (MCAR/CCH and RMSR) 






X'20' 


MCAR/CCH support 


65 


41 


X'80' 


Initial selection of ErP 






X'40' 


Reserved 






X'20' 


Timer interrupt pending 






X'10' 


MICR Stacker-select active 






X'08' 


Invalid address during fetch 






X'04' 


SIO routine entered after interrupt 






X'02' 


Reserved 






x'or 


IPL in progress 


66 


42 


X'80' 


Initial RAS request 






X'40' 


RAS WAIT request outstanding 






X'20' 


RAS IPL in progress 






X'10' 


Reserved 






X'08' 


POWER supported 






X'04' 


POWER initialized 






X'02'. 


GETREAL forSDAID in progress 






x'or 


Fetch for system task in progress (used by PDAlD's) 


67 


43 


Reserved 





LAYOUT OF SYSTEM TASK SELECTION CONTROL FIELD 



244 F4 


SVA Flag 




X'80' Do not test for warm start copy of SVA 




X'40' SDL active 




X'20' No 'Set SVA' or 'Set SDL. allowed 




X'10' Build of SDL in progress 




X'08' SDL overflow 




X'04'} 




X'02' > Reserved 




X'OV J 



Dec 


Hex 


Description 


68 


44 


Always zero 


69 


45 


SELECT byte: 

X'00' No system task active 

X'OV RAS active 

X'02' PMGR active 

X'03' SUPVR active 

X'04' CRT active 

X'05' ERP active 

X'06' PAGEIN active 



Figure 4.5 



SYSCOM Expansion flag bytes. 
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I/O TABLES AND 
INFORMATION BLOCKS 



The I/O tables and information blocks in the supervisor establish the interface 
between a specific task and the hardware channels. For example, for every logical 
unit name (SYSXXX) used, there must be a.LUB (Logical Unit Block) entry. For 
every physical device used by the system, there must be a PUB (Physical Unit 
Block) entry. Then, when an I/O request occurs, an entry is made, via LUB and 
PUB, in the CHANQ (Channel Queue). An I/O request queued in the CHANQ 
contains an address that points to the CCB (Command Control Block) that 
contains the address of the channel program. 

During the I/O device operation, entries are made in the ERRQ (Error Queue) in 
the Error Recovery Block, if a hardware failure occurs on the device. 

Figure 4.6 (opposite) is an overall picture that illustrates the connections between 
the tables, (It does not represent their actual position, size, or relation as they are 
stored or printed in a dump output.) The initial pointers for all the tables and 
blocks are stored either in SYSCOM or in the active partition comreg. 

Where a connection exists between tables, for example, the PUB and the CHANQ, 
pointers are contained in the table entries concerned. For example, the Figure 
shows a one-byte pointer in the PUB entry number 00 that relates this PUB entry 
to CHANQ entry number 00. 

Figures 4.7 through 4.16 show the format of the tables and describe their contents. 

A formatted stand-alone dump output prints the contents of the tables in a more 
readily understood format, and an example of such an output is shown in appendix 
G. The stand-alone dump program is described in Section 2 -A of this manual. 



( 
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Byte 0: Channel number. (Hex 0-6, FF = NULL) 

Byte 1 : I/O device unit number 

Byte 2: Hex 0, 1 , 2, points to the first channel queue entry for this device. 

Byte 3: If device is a 2495 Tape Cartridge Reader and TEBs are specified, this 

byte is a TEB pointer (Hex 1, 2, 3 ). Otherwise, this byte is a ERP retry counter. 

Byte 4: Device type code. See Figure 4.10, parts 1 through 3. 

Byte 5: SS of the MODE= parameter in the DVCGEN macro for tape unit (See Section 2). 
For the Models 115 and 125 ICA line, this byte contains the displacement index of 
the entry in the Line Mode Table (LMT). The address of the LMT is contained 
in bytes X'8C - X'8F' of SYSCOM. 

For DASD with seek separation, this byte is used as the SAB Pointer. 
With Track Hold but not seek separation supported, this byte contains 
a pointer to the Track Hold Table entry or X'FF' (with both SKSEP and 
TRKHLD specified, the track hold pointer is found in the SAB entry). 

For MICR type devices/this byte indicates which external interrupt line 
is in use. 

For a 3705 Communications Controller, this byte contains the type number 
of the Channel Adapter. 

For 2560 or 5425 

Bit 0: 1= Repositioning required 

1: 0= SYSPCH temporarily assigned to hopper 1 

1= SYSPCH temporarily assigned to hopper 2 
2: 0= SYSIPT temporarily assigned to hopper 1 

1= SYSIPT temporarily assigned to hopper 2 
3: 0= SYSRDR temporarily assigned to hopper 1 

1= SYSRDR temporarily assigned to hopper 2 
5: 0= SYSPCH permanently assigned to hopper 1 

1= SYSPCH permanently assigned to hopper 2 
6: 0= SYSIPT permanently assigned to hopper 1 

1= SYSIPT permanently assigned to hopper 2 
7: 0= SYSRDR permanently assigned to hopper 1 

1= SYSRDR permanently assigned to hopper 2. 

Byte 6: Channel Scheduler Flags 

Bit 0: 1= Device busy 

1 : 1= Switchable device 

2: 1= EOJ for SYSRDR or SYSIPT 

3: 1= I/O error queued for recovery 

4: 1= Operator intervention required 

5: 1= Device End posting required 

6: 1= Burst mode or overrunnable device on byte MPX channel 

7: 1= 7-track tape unit. 

Byte 7: Job Control Flags 

Bit 0-4: Standard MODE assignment for 7-track tape (all ones 
if not tape, all zeros if device is down) 

Bit 5: 1 = DASD device with Rotational Position Sensing (RPS) feature 

Bit 6-7: B'11' (both on)= Headqueue in progress 
B'01 ' = Headqueue requested. 



%! 



Figure 4.9. 



Note: A null is generated for each device to be supported by the supervisor. Standard physical 
unit assignments are made to the PUB table at supervisor generation time. 
PUBs are ordered by channel and priority within a channel. 

An entry in the PUB Ownership Table is associated with each entry in the PUB Table, 
if the supervisor has been generated to support multiprogramming. 

Explanation of the contents of an entry in the PUB table 
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Card 
Code 


Actual IBM Device 


Device- 
Type X'nn' 


Device Type 


2400T9 


9-track Magnetic Tape 
Tape units 


50 




2400T7 


7-track Magnetic 
Tape units 


50 




341 0T9 


9-track 3410 Magnetic 


53 






Tape units 




Magnetic Tape devices 


341 0T7 


7-track 3410 Magnetic 
Tape units 


53 




3420T9 


9-track 3420 Magnetic 
Tape units 


52 




3420T7 


7-track 3420 Magnetic 
Tape units 


52 




2495TC 


2495 Tape Cartridge 
Reader 


51 


Tape Cartridge Reader 


1442N1 


1442N1 Card Read Punch 


30 




2520B1 


2520B1 Card Read Punch 


31 




2560 


2560 Multifunction Card 


33 






machine 




Card Read Punches 


2596 


2596 Card Read Punch 


30 




3525RP 


3525 Card Punch (with 
optional read feature) 


32 




5425 


5425 Multifunction Card 
Unit 


34 




2501 


2501 Card Reader 


10 




2540R 


2540 Card Reader 


11 




3504 


3504 Card Reader 


12 


Card Readers 


3505 


3505 Card Reader 


12 




1540P 


2540 Card Punch 


21 




2520B2 


2520B2 Card Punch 


20 




1442N2 


1442N2 Card Punch 


22 


Card Punches 


2520B3 


2520B3 Card Punch 


20 




3525P 


3525 Card Punch 


23 




1403 


1403 Printer 


40 




1403U 


1403 Printer with UCS 
feature 


42 




1443 


1443 Printer 


41 




2260(local) 


1053 Printer with 2848 
Control Unit. MODE 
operand must be entered 
asX'01' 


CO 




3203 


3203 Printer 


4A 




3211 


3211 Printer 


43 


Printers 


3277 


3284 or 3286 Printer with 


BO 




(local 3270) 


3272 Control Unit. MODE 
operand must be entered 
asX'01' 






327 7 B 


3284 or 3286 Printer with 


BO 




(local 3270) 


3272 Control Unit, attached 
in burst mode to a multi- 
plexer channel. MODE 
operand must be entered 
as X'01 ' 






5203 


5203 Printer 


4C 




52030 


5203 Printer with 
UCS feature 


4D 
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Card 
Code 


Actual IBM Device 


Device - 
Type X'nn' 


Device Type 


1050A 


3210, 3215 Console 
Printer Keyboards 


00 


Printer-Keyboards 


125D 
125DP 


Models 115 and 125 Integrated 

Video Display Unit 

Models 115 and 125 Integrated 

Video Display Unit 

with 5213 Console Printer 

attached 


B2 
B2 


Video Display Unit 


UNSP 
UNSPB 


Unsupported device 
Unsupported device 


FF 
FF 


Unsupported. No burst mode 
on multiplexer channel 
Unsupported with burst 
mode on multiplexer 
channel 


2311 
2314 

2314 
2321 
3330 

3340 

3340 

3340 


231 1 Disk Storage device 

2314 Direct Access 

Storage Facility 

2319 Disk Storage Facility 

2321 Data Cell Drive 

3330-1,3330-2, or 333-1 

Disk Storage 

3340 Disk Storage 

(general) 

3340 Disk Storage 

with 3348 Mod 35 

3340 Disk Storage 

with 3348 Mod 70 


60 
62 

62 
61 
63 

68 

69 
6A 


DASD 


1419 

1419 

1419 

1419P 

1419S 


1255 Magnetic Character 

Reader 

1259 Magnetic Character 

Reader 

1419 Magnetic Character 

Reader 

1419 Dual Address Adapter 

Primary Control Unit 

1419 Dual Address Adapter 

Secondary Contr. Unit 


72 
72 
72 
73 
74 


MICR- Magnetic Ink 
Character Recognition 
devices 


2701 

A 
2702 I 

D 
2703 

2703 
2703 


2701/2715 Data Adapter 
Unit 

2702 Transmission Control 
Unit 

2703 Transmission Control 
Unit 

Integrated Communications 
Adapter (Models 125 and 135) 
3705 Communications 
Controller in Emulation 
Mode 


DO 
D1 

D2 

D2 
D2 


Teleprocessing lines 

A= SADO comm'd 

r, r. » r^* , . when 

B= SAD1 comm d 

^ ,■>» ~„ . . enab mq 

C= SAD2 comm'd , ,. b 

^ o» r^ / . the line 

D= SAD3 comm'd 


2955 


2955 Data Adapter Unit 


D7 


Data Link for RETAIN 


1017 
2671 


1017 Paper Tape Reader 
with 2826 Control Unit 
2671 Paper Tape Reader 


78 
70 


Paper Tape Readers 



I/O TABLES AND 
INFORMATION BLOCKS 



Figure 4.10 
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Card 
Code 


Actual IBM Device 


Device- 
Type X'nn' 


Device Type 


1018 


1018 Paper Tape Punch 
with 2826 Control Unit 


79 


Paper Tape Punch 


1419 

1419P 

1419S 


1270 Optical Reader/ 

Sorter 

1275 Optical Reader/ 

Sorter Primary Control Unit 

1275 Optical Reader/Sorter 

Secundary Control Unit 


72 
73 
73 


Optical Readers 


1287 
1288 
3881 
3886 

3540 


1 287 Optical Reader 

1288 Optical Page Reader 
*3881 Optical Mark Reader 

3886 Optical Character 

Reader 

3540 Diskette I/O unit 


77 
77 
11 
7C 


Optical Readers 
DISKETTE 


2260 
3277 
(local 3270) 

3277 B 
(local 3270) 


2260 Display Station 
3277 Display Station; 
MODE operand need not 
be entered 

3277 Display Station; 
attached in burst mode to 
a multiplexer channel. 
MODE operand need not 
be entered 


CO 
B0 

B0 


Display Stations 


7770 


7770 Audio Response Unit 


D3 


Audio Response unit 



*Note: The logical unit name SYSIN cannot be assigned to a 3881 
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PROBLEM 






LOGICAL 








PHYSICAL 




I/O 


PROGRAM 




IOCS 




IOCS 




DEVICE 




Provide a new 






Issue READ 




request (refer 




logical record from 










to the file 




a physical block in 










description 

elsewhere 

in the program). 






the I/O area 

• (deblock) 














to the 








problem program, 
















OR 
















If actual input is 
















required (new 




Determine channel 






block), issue a 










physical read 




and: 












request (EXCP. 






a) If channel is not 






AND { 

WAIT 




















. Start device 
■ 
















I 








b) If channel is busy, 




| 








f 
When I/O is com- 
plete, provide the 
first (or only) 
logical record from 
the new block in 
the I/O area to the 








place request into 
channel queue and 
return to LIOCS. 




T 
Data transfer 

\ 

I/O complete 




(Supervisor will 
retry later.) 


f 










' 








When I/O is com- 
plete, return to 
LIOCS via interrupt 






Next instruction 
after READ 




program. 






handling routine 


request. 





















Section 4, Chapter 4 

I/O CONTROL 
SYSTEM 



Figure 4.17 Example of LIOCS and PIOCS interrelationship . 



Explanation of Figure 4.17: 

Logical IOCS makes a request to physical IOCS to start an I/O operation by means 
of the EXCP macro instruction. From information in the CCB, physical IOCS 
determines the channel for which the request was made and places the request on 
a queue for that device. If the channel(s) or device is not busy, the I/O is started 
and control returns to the problem program. If the channel is busy, control 
returns to the supervisor task selection routines, but the I/O request waits in the 
channel queue. When the request reaches the top of the channel queue, the I/O 
is started. 

Control returns to the program requesting the I/O unless there was an error 
condition detected on the START I/O (SIO) instruction. The problem program 
normally continues processing until it requires that the requested I/O operation 
be complete (either the information being read into real storage is needed, or the 
output area must be freed on an output operation). At this time, the WAIT macro 
causes the now waiting task to be removed from task selection until the proper 
interrupt is processed for this device by the supervisor. 
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Using PIOCS and LIOCS Macro Instructions. 

By use of macro instructions you can create, access and maintain files at both 
physical and logical IOCS levels. Through these macro instructions, the user can 
communicate with the pre-written routines and tailor them to his needs. 

As part of most user programs, LIOCS provides an interface between user programs, 
LIOCS provides an interface between user's file processing routines and PIOCS. 
(All COBOL, FORTRAN, RPG II, PL 1 OPT and PL/I(D) programs use LIOCS; 
most assembler programs use LIOCS.) 



Using PIOCS 

Using PIOCS requires a detailed knowledge of device control and system operation. 
A channel program using the CCW assembler instruction must be written in con- 
junction with three macro instructions provided to communicate with PIOCS. 

CCB: This macro instruction generates a command control block. (Refer to 
Chapter 5 in this Section for a description of the CCB.) 

EXCP: This macro instruction is converted to an SVC to request execution of 
the channel program. It supplies the location of the corresponding CCB 
to the supervisor. 

WAIT: This macro instruction generates an SVC 7 which, tests CCB byte 2 bit 
(traffic bit) to determine when an I/O operation is complete. If the 
operation is not complete, the supervisor gets control until PIOCS within 
the supervisor sets the traffic bit to indicate completion of the operation. 
The WAIT macro should always be used for each I/O operation. 

A channel program written to make use of the RPS feature of a direct-access 

device must contain Set Sector commands and either Read Sector commands or the 

SECTVAL macro instruction. 

SECTVAL: This macro instruction generates an SVC 75 to supply the 
sector in which the record is located. 

For information on the format of Sector CCWs and on Rotation Position 

Sensing see the Appropriate reference manuel for the device. 

The example below shows part of an assembly program listing using the EXCP 
WAIT and CCB macros. A full description of these MACRO instructions can be 
found in DOS/VS Supervisor and I/O Macros. 



























• 


003B00 


47F0 


B75C 


03F5E 


261 


^ * 


















262 


«*«*«**»**»*****«*****»♦**«***»**«*»»»**«»***«***«»*««»**«*«*»*»»*»»»«« 




















263 


♦BUG GENERATOR ROUTINE* 










• 










264 


**»*»»*»*****»«*«»**»**»*******«***»«*«*»***********«**«**»**»*»*«»«*«* 










003B04 


5010 


C61E 


04E20 


265 


BUG ST 1.R1SAVE SAVE CONTENTS OF RETURN REGISTER 




















266 


EXCP TCCB1 










• 










270 


WAIT TCCB1 


















276 


EXCP TCCB2 




















280 


WAIT TCCB2 










• 


003B30 


9640 


C83F 


05041 


286 


01 OPRESPl.X'40' 










00383+ 


9503 


C83F 


05041 


287 


CLI OPRESPltC'L* 


(/Txg3 


trfti 























^Z 004E8C 
• 004E90 


40404040 
4040404040404040 


1348 


TOWN 


DC 


CLIO' ■ 








1349 


TCCB1 


CCB 


SYSLOG.TCCWltX'O+OO' 








1360 


TCCB2 


CCB 


SYSL0G,TCCW2,X , 0400' 




• 004EBA 


000000000000 












004EC0 


09004F106000001C 


1371 


TCCW1 


CCW 


09,NSSG1.X'60*,28 




_ 004EC8 


09004F2C60000020 


1372 




CCW 


09,MSSG2,X>60 , ,32 




• 004 EDO 


09004F4C6000002F 


1373 




CCW 


09,MSSG3,X , 60«,47 




004E08 


09004F7B6000001F 


1374 




CCW 


09,HSSG4,X , 60 > .31 




. 004EE0 


09004F9A60000021 


1375 




CCW 


09,MSSG5,X'60',33 




• 004EE8 


09004FBB60000021 


1376 




ccw 


09,MSSG6,X , 60',33 




004EFO 


09004FOC60000020 


1377 




CCW 


09,MSSG7,X'60',32 




— 004EF8 


09004FFC60000020 


1378 




CCW 


09,MSSG8 t X'60',32 




• 004FOO 


0900501C20000025 


1379 




CCW 


09,MSSG9,X'20«,37 




004F08 


OA00504120000001 


1380 


TCCW2 


CCW 


10,OPRESP1,X'20',1 








1381 


*»******»♦»****«**♦«*»«****«»***»***»»****»**»«»**»*****»***********«*» 


(fr *? Art) 






1382 


♦MESSAGE 


CONSTANTS* 



c 
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Problem (user) program listing. 



I/O CONTROL 
SYSTEM 




ERROPT=YES, 
[— READ=FORWARD f 
RECFORM=FIXUNB, 
TYPEFLE=INPUT 



Figure 4.24. A summary of the relationships between an imperative macro, a declarative macro, and a module 
generation macro specified in a program. 

The GET imperative macro is used in this illustration, which also shows the linkage between the generated DTF table and the 
logic module. 
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RPS (Rotational Position Sensing) Option 

System Support 

RPS support for devices attached to block multiplexer channels in full block 
multiplex mode (or their equivalent on Model 31 15/3125 CPUs) is provided as an 
option in DOS/VS. The option is specifiable at the operating system and device 
level. System support is provided at system generation time by coding the FOPT 
macro with RPS=YES. The IBM 3330/3333 supports RPS as a standard feature. 
The IBM 3340 supports RPS when 3340R is specified in the DVCGEN macro. 
Please note that Block Multiplexing cannot be used with the 231 1-1/3330, 
2311-1/3340, and 2314/3340 Series Compatibility Features, if your CPU is a 
Model 3115 or a Model 3125. 

Data Management Support 

RPS support will be provided dynamically in Data Management when the 
operating system and the device support'and all of the following conditions are met: 

• One of the DASD access methods is being used, that is, the file is defined by one 
of the following DTFs: DTFSD, DTFDA, DTFIS, DTFDI, or DTFPH . 

• There is room in the user's virtual storage to extend the DTF. 

• An RPS version of the logic module necessary to process the DTF has been, or 
can be, loaded into the SVA. 



At OPEN time, if it is determined that the system and the device both support 
RPS, a bit is set in the DTF tables (see Figure 4.24A). This bit will not be turned 
off until CLOSE time whether or not the other conditions for RPS support are 
met. Space is then obtained for the DTF extension. The amount is dependent on 
which access method is in use (see Figure 4.24A). If space is unavailable, the 
DTF will be opened without RPS support. 

Determination as to which RPS logic module is required to process this DTF is 
made and the module is loaded into the SVA, unless it is already there in which 
case it is sharable across partitions. If the required logic module cannot be made 
available, OPEN releases the DTF extension space and the DTF is opened 
without RPS support. 

If the space for the DTF extenstion is available and the RPS logic module is loaded 
into the SVA, OPEN sets another bit in the DTF table indicating that the data set 
will be processed in RPS mode (see Figure 4.24A). 

The first section of the DTF extension contains the RPS channel program (so that 
the pointer to the extension is also the pointer to the RPS CCW chain). The 
extension also contains CCW build and work areas necessary to construct the RPS 
channel program, a sector value bucket, and register and address save areas (see 
Figure 4.24B for DTF extension format). 

The addresses of the original channel program and logic module are saved in the 
extension while the address of the RPS channel program is put into bytes 9 - 1 1 of 
the DTF and the address of the RPS logic module is put into bytes 17-19. These 
pointers are restored at CLOSE time. 

The original DTF is used for all fields except the channel program so that no 
mapping between the DTF and the extension is required, (see Figure 4.2 4C for an 
overview of the OPEN.) 



if 
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No program recompiling or relink -editing is required, though there must be enough 
dynamically allocatable space in the user's partition for the RPS extensions. Since 
RPS gets this space via the GETVIS macro, the SIZE= parameter must be 
specified in the program's EXEC statement. 

The DTF extension provides a register save area for the RPS logic modules since 
they are all reentrant and sharable between partitions. If the original non-RPS 
logic module is reentrant because it was coded read-only, the user-supplied save 
area will not be used. The RPS logic modules are supersets of functions needed 
to process the DTF. 

System Component Support 

System Components support RPS where there is a significant amount of DASD I/O. 
This support is provided by building RPS channel commands and then changing 
these to NO-OPs or TICs if the affected device or system does not support RPS. 

Wherever the component uses LIOCS for its I/O, this optional support is provided 
through the data management support of RPS. 

Where LIOCS is not used, the component logic interrogates the indicator set by 
OPEN for I/O using DTFPH or, when DTFPH is not used, the same PUB and 
COMREG indicators interrogated by OPEN. 
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The system components supporting RPS are : 

• POWER 

• Supervisor Fetch and Paging I/O 

• Linkage Editor 

• Job Control 

• Librarian 

• Checkpoint/Restart 

• System Utilities 





DTFDA 
DTFPH* 


DTFSD 
DTFPH* 


DTFSD 

(work 

files) 


DTFDI 


DTFIS 

(All) 


DTF offset: set at byte 


32(20) 


44(2C) 


37(25) 


42(2A) 


65(41) 


System supports 
RPS bit 


1 


1 


1 


7 


4,7# 


DTF has been 
extended bit 


7 


7 


7 


1 


5 


Length of DTF 
extension 


512 


256 


256 


256 


384 



* DTFPH has no logic module; therefore, the only RPS processing done is the setting of the 
System Support RPS bit. 

$ Bit 4 on - prime data resides on an RPS device 
Bit 7 on - index resides on an RPS device 

Figure 4.24A. DTFs for RPS Support 
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0(0) 



RPS Channel Program 
(variable length) 



Work Space 



176(B0) Address of Original Channel Program 180(B4) Address of Original Logic Module 



172 (AC) 



Sector Values (up to 4) 



184(B8) 



72-Byte Register Save Area 



256(100) 



Additional Work Space 

not present for SAM or Device Independence 

(This field is 256 bytes for DAM and 128 bytes for ISAM) 



Z-' 



Figure 4.24B DTF Extension Work Area for RPS 
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BEFORE OPEN 
(and after CLOSE) 



AFTER OPEN 





USER'S PROGRAM 
DTF 




1 


CCB CCW ^ 
--MODf ] 




1 1 
1 1 

1 «* 




Channel Program 






i--* 


Non-RPS module 
(LIOCS module refer- 
red to by the DTF 
and link-edited with 
user's program 









USER'S PROGRAM 
DTF 



CCB CCW 



4 



MOD* 





USER'S VIRTUAL STORAGE 



RPS CHANNEL PROGRAM 



(see Figure 4.24B) 
I 
I 
l 
I 
| SHARED VIRTUAL AREA 



l 
I 











RPS LIOCS 
Module 











Figure 4.24C Effect of RPS Support on OPEN 
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S YSTE M VSAM IOCS differs from that of other DOS/VS access methods as follows: 

• VSAM declarative macros are ACB, EXLST, and RPL instead of DTF and 
xxMOD. 

• VSAM routines are dynamically loaded into virtual storage when a VSAM 
file is opened. They are not assembled or link edited with the user's 
program. 

Declarative Macros 

The VSAM declarative macros are ACB, which creates an Access-Method Control 
Block; EXLST, which creates an Exit List; and RPL, which creates a Request 
Parameter List. The Access-Method Control Block (ACB) is like a DTF in that it 
defines the file to be processed. Opening a VSAM file involves opening the ACB 
for that file. The Request Parameter List (RPL) defines the parameters necessary 
for a particular execution of a request (imperative) macro. It contains some of the 
information, such as address of the user's work area, located in the DTF in other 
access methods. The Exit List (EXLST) contains the addresses of optional user 
exit routines. Up to four exit routines can be specified— one for handling end-of- 
file, one for handling logical errors, one for handling I/O errors, and one to allow 
user processing during VSAM I/O operations. 

Codes indicating errors resulting from execution of imperative macros are set in 
registers or in the ACB or RPL as described below. 

Imperative Macros 

The user's program issues imperative macros to open or close a file and to retrieve, 
add, delete, or update records. It can also issue imperative macros to generate, 
modify, display, or test the control blocks created by the declarative macros. When 
control is returned to the user's program after execution of an imperative macro, a 
"return code" is set in the low-order byte of register 15. The return code indicates 
the results of the macro execution. If an error or certain other exceptional 
conditions occur, an "error code" will be set in the ACB, the RPL, or in register 0, 
depending on the macro. Figure xx summarizes the return codes and error codes 
issued by the imperative macros and user exit routines which can be used. More 
information on the return codes and user exits as well as a complete list of the error 
codes and their meanings is in the VSAM chapter of DOS/VS Supervisor and I/O 
Macros. 

An ACB, EXLST, or RPL can be created dynamically, during program execution, 
by using the GENCB macro. The fields in these control blocks can be modified 
during program execution by using the MODCB macro. Refer to DOS/VS 
Supervisor and I/O Macros for information on how to write the GENCB and 
MODCB macros. 

RPL Debugging Hints 

If the RPL hold byte, 35(23), is set to X'FF', the error occurred while the request 
was being executed by VSAM. Check the type of request byte, 29(1 D), to 
determine what request was active. If the request was a POINT, GET, or PUT, 
check the following parameters in the RPL (of GENCB for RPL) in your program 
to ensure that they are valid: 
Macro Check these RPL Parameters 

POINT ARG and KEYLEN 

GET AREA and AREALEN 

IF OPTCD=DIR or OPTCD=SKP, also check ARG and KEYLEN 

PUT AREA and RECLEN 

If the RPL parameters are specified correctly or if the type of request is other than 
POINT, GET, or PUT, the error is probably in VSAM itself. Save the dump, console 
log, and program listing and contact your IBM programming support representative. 

Note: MODCB, SHOWCB, and TESTCB macros also set the RPL Hold byte. If this 
byte was set by one of those macros, the type of request byte will have no meaning. 
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Command Control Block (CCB) CCB AND THE 

CHANNEL PROGRAM 

This information block is generated in the problem program during assembly or 
during program operation, depending on the methods of I/O control employed by 
the program. As described in Chapter 4 the CCB is generated as the first 1 6 bytes of 
a DTF when the program is using LIOCS. When using PIOCS, the CCB macro 
generates the CCB. 

The CCB establishes communication between the problem program and physical 
IOCS. The CCB is 16 bytes in length with eight major fields, and does not have to be 
aligned on a doubleword boundary. Eight optional bytes are generated if the user 
requests that a sense operation be performed on the occurrence of an I/O error. 
Data transferred from the device to real storage during a sense operation provides 
information concerning unusual conditions detected in the last operation and the 
status of the device. All data in the CCB is in the hexadecimal format. 

By examining the contents of the CCB in a dump, the following information can 
be obtained about the associated I/O operation: 

• Whether the operation was completed (by inspecting the traffic bit and 
device-end bit) 

Status of the channel and device to which the I/O command was issued 
The logical unit involved in the operation 
Whether the CCB is in a real or a virtual partition 
The address of the channel program (the first CCW in a CCW string) 
The address of the next CCW to be executedin the channel program 
(Subtracting eight from this address gives the address of the last CCW used.) 
The residual count associated with the last CCW. 

. Note: When all the following coditions have been met, bytes 9-11 will now be 

y pointing to a non-RPS channel program in the DTF, but the one actually used 
has been released from the user's virtual save area: 

• RPS was in effect . 

• The data set has been closed. 

• The CCB was generated as the first 1 6 bytes of a DTF 
in a program using LIOCS. 

This count taken from the channel status word (CSW), is stored by PIOCS when 
the pointer to this CCB is removed from the channel queue. The residual count, in 
conjunction with the original count specified in the last CCW used, indicates the 
number of bytes transferred to or from the area designated by the CCW. When an 
input operation is terminated, the difference between the original count in the 
CCW and the residual count in the CSW is equal to the number of bytes transferred 
to storage. For an output operation, the difference is equal to the number of 
bytes transferred to the I/O device. 
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How to locate 

1. For programs using LIOCS, locate the address of the associated DTF in the 
program listing. Then use the linkage editor map to locate the DTF in the dump. 
The first 1 6 bytes of the DTF is the CCB. 



2. For programs using PIOCS, locate the address of the CCB macro in the program 
listing and use the linkage editor map to locate the CCB in the dump. 

3. If the interrupt code in the PSW stored in the partition save area is 00 or 07 
(SVC or SVC 7), the contents of general register 1 may contain the address of 
the CCB. To confirm whether the address in register 1 is that of a CCB, inspect 
the first few bytes starting from that address. (It is not difficult to recognize 

a valid CCB in a dump. See the example below.) 



FP REG 
CR O-F 



O00O00 
000020 



BUGPRGCK 

8004008C 
000420C8 
00000000 
004000FF 
OOOOFFFF 
BG ADDR 



0040821 
0*16l 
00000000 
000OE64O 
00000000 
IS 000**0 



12/06/73 

00061000 
00000000 
00000000 
FFFFFFFF 
00000000 



00000000 
47000000 



oooooooo 

OOOO850E 



OOOOOOOO 
440C0000 



JS 10.41.55 PAGE 1 

O000E43O 0000E4B2 80000015 80000015 00060FFF <• A~L ~/ss*~J, 

4004007* 0004107* 07C8C1E2 C55C5C5C 00061000 3*i&'l&t?l, 0*"v7r*pl*' 

OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO oooooooo _£. / S / / 

FFFFFFFF OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO J&V' *CasfVCjbC&CC 0*<K&- 

OOFFFFFF OOOOOOOO OOOOOOOO C2000000 00000200 j 

OOOOOOOO OOOOOOOO OOOOo5*W40000000 OOOOOOOO &(?.... ........... ........ ....... 

00000902 OOOOOOOO OOOOOOOO 470C2000 0000090C K •** / <VS'7Wy 



040740 
040760 
040780 
07*0 
040 7C0 
0407E0 
040800 
040820 



7*AI7-*040840 



040860 
040880 
0408*0 
0408C0 



I 



CE29D202 B94DC677 020B8952 C0EE0202 B950C67B 0210B962 CD9E0202 B972C67F 
020CB977 CE3CD202 B983C683 5810C0AE 58F10010 45EFOO0C 5810CDAE 41000008 

58Fiooi C8itoJ^Z-1(<Zy&<s &f) P „* „~. *.,,,.*..««« ~~—-. 

EH fefesf^ A^^W^i 

4110C08 ] C _^_____ / "'~ 

-03 OqtUflsssI 66600000 



OOOOOOOO 00040845/66000000 86BCF018 



/DO 
)00 



^^3^m\f^^S5smwsss5sas^sSBSa 



00041019 00041019)00000050 00041338 



o*o«eo Cotc*U'-0 iVitMLxf) 

040940 00008000 00000004 TI0040958 OOOOOOOO 



J— PT/? 



ETAPEOUT) .- 



".lttUUUl 4 fOUUUUU JUIU-HUI^ [«UWJ^I j 

0320031F 004F0000a 00008000yO0000103 

V cc y e ^^\\vp\\\\ cos *«/ '}< 

y os 2*6 -o/ ■• w,*/*: W'X'.'.W,'., £>T^ ^6*4 o/<'^.\ 



(£x S?Sa 



Figure 4.26 The pointer and CCB in a dump 

Figure 4.27 parts 1, 2 and 3 illustrate the format and contents of the information 
contained in any CCB. 
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SUPERVISOR CALLS 



SVC 
Dec Hex 


Macro supported 


Function 


50 


32 




Reserved for LIOCS error recovery 


51 


33 




Return phase header 


52* 


34 


TTIMER 


Return the remaining time interval, or cancel a time 
interval 


53 


35 




Reserved 


54 


36 


FREEREAL 




55 


37 


GETREAL 


Provide interf. between SDAID and PDAID initialization 
routine and page management routine, to create the 
PDAID alternate area or the SD area 


56* 


38 


GETPUB- 








FREEPUB 


Occupy or free PUB of the device used by POWER 


57* 


39 




Make POWER-supported partition dispatchable 


58 


3A 




Provide interface between job control and the supervisor. 
Get real storage for real jobs 


59 


3B 




Provide interface between EOJ and the supervisor. Reset 
the storage key for virtual jobs 


60 


3C 


GETADR 


Provide virtual address of location within I/O areas for 
ERP and CRT routines 


61* 


3D 


GETVIS 


Get storage in virtual partition 


62* 


3E 


FREEVIS 


Free storage in virtual partition 


63 


3F 


USE 


Use a resource 


64 


40 


RELEASE 


Release a resource 


65* 


41 


CDLOAD 


Load VSAM or core image phase 


66 


42 


RUNMODE 


Return mode in which program is running 


67* 


43 


PFIX 


Fix page(s) in real storage 


68* 


44 


PFREE 


Free page(s) in real storage 


69* 


45 


REALAD 


Return real address corresponding to a given virtual 
address 


70* 


46 


VIRTAD 


Return virtual address corresponding to a given real 
address 


71* 


47 


SETPFA 


Establish or terminate the linkage between the supervisor 
and a user page-fault appendage routine 


72* 


48 


GETCBUF- 








FREECBUF 


Get or free copy buffer for IDAL or tape ERP 


73* 


49 


SETAPP 


Allow linkage to channel and appendage routines 


74* 


4A 




Fix page(s) in real storage for restart 


75 


4B 




SECTVAL Calculate value of sector for RPS 


76 


4C 




Initiate RMS recording of an I/O error 


77 


4D 


TRANSCSW 


Returns the virtual address of a copied CCW 


78 thru 84 




Reserved 


85 


55 


RE LP AG 


Release contents of one or more pages 


86 


56 


FCEPGOUT 


Force a page-out for one or more pages 


87 


57 


PAGEIN 


Page in one or more pages 



* optional 

Figure 4.29 
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Section 4, Chapter 7 

PIB AND PIB2 



The PIB (program Information Block) 

Real storage area is reserved in the supervisor for this information block by the 
MPS multiprogramming and/ or NPARTS and AP (Asynchronous Processing) 
parameters of the SUPVR supervisor generation macro. Each entry in this block is 
16 bytes and contains status information about the program and, if AP is supported 
about the subtasks running in each partition supported by the supervisor. 

The first entry is reserved for the attention routine, this entry is called the 
Attention PIB (AR PIB). 

Other entries in the PIB belong to the problem programs and subtasks. The sum of 
all subtasks and problem program entries may not exceed 15. The maximum number 
of entries, including the attention PIB and AP (subtask) PIBs, is 16. 

For a supervisor that is not generated to support more than one partition there is 
only one 16-byte entry, which is shared by the attention routine and the 
problem program. 



By examining the data recorded in the appropriate PIB entry, the status and 
location of programs running in any partition can be established. Some of the 
more important data to be looked at in the PIB during the first analysis of a dump 
output are: 

• Byte 0, from which you can determine whether the program is waiting for 

• The LTA (Logical Transient Area), X'8I' 

• The PTA (Physical Transient Area), X'85' 

• An I/O interrupt, X'82' 

• A page to be paged in, X'87' 

• A page to be paged in with QTAM active, X'8F' 

• Byte 4, X'80', which indicates that the job or task is running in virtual mode 

• The address of the program save area 

• The address of the system save area. 



Figure 4.30 (opposite) shows the format and describes the contents of an entry 
in the PIB. 



How to locate: 

Bytes X'5A' — X'5B' of the partition comregs contain the address of the first entry 
in this information block. Label PIBTAB in the supervisor listing identifies the 
address of the first byte of this information block. 

Appendix G shows an example of locating the PIB in a dump output. 



if 
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Appendix G 

EXAMPLE OF A 
STAND ALONE 
DUMP OUTPUT 




















IJBSEGT CONTENTS IS TAKEN TC 


LOCATE THE SEGMENT TABLE 






• VIRT.AODR 


REAL ADOR 
OOOOOO 


BLOCK 
000 


STATUS 

CHANGED "^ 
CHANGED 








r^ oooooo 






000800 


000800 


001 










001000 


001000 


002 


CHANGED 










001800 


001800 


003 


UNCHANGED 










002000 


002000 


004 


CHANGED 










002800 


002800 


005 


CHANGED 










003000 


003000 


006 


UNCHANGED 










003800 


003800 


007 


CHANGED 










004000 


004000 


008 


CHANGED 










004800 


004800 


009 


CHANGED 










005000 


005000 


010 


CHANGED 










005800 


005800 


Oil 


CHANGED 










006000 


006000 


012 


CHANGEO 










006800 


006800 


013 


UNCHANGED 










l 007000 


OOTOOr 


014 


CHANGEO 


/ jf i 






m C.ftr^ 008000 


007800 
008000 


015 
016 


CHANGEO 
CHANGED 








lO 008800 
^ 009000 
• 009800 


008800 
009000 
009800 


017 
018 
019 


CHANGED 
CHANGED 
UNCHANCED 








OOAOOO 


OOAOOO 


020 


CHANGED 










00A800 


00A800 


021 


CHANGED 










OOBOOO 


OOBOOO 


022 


CHANGED 










008800 


008-800 


023 


CHANGEO 










OOCOOO 


OOCOOO 


024 


CHANGED 










00C800 


00C800 


025 


CHANGED 










OOOOOO 


OOOOOO 


026 


CHANGED 










00D800 


00D800 


027 


CHANGED 










OOEOOO 


OOEOOO 


028 


CHANGED 










00E800 


0OE8OO 


029 


CHANGED 


1 








OOFOOO 


OOFOOO 


030 


CHANGED } 








• 


1 00F800 


00F80O 
010000 


031 
032 


CHANGED / 
CHANGEO "\ 






m 010000 




• 010800 


010800 


033 


CHANGEO 








011000 


011000 


034 


CHANGED 








m 011800 


011800 


035 


CHANGED 








• 012000 


012000 


036 


CHANGED 








012800 


012800 


037 


CHANGED 


i A * yt — - * 






m 013000 
w 013800 


013000 
013800 


038 
039 


CHANGEO 
CHANGED 








014000 
A 014800 
• 015000 


014000 
014800 
015000 


040 
041 
042 


CHANGED 
CHANGED 
CHANGEO 






01S800 
A 016000 
• 016800 


015800 
016000 
016800 


043 
044 
045 


CHANGED 
CHANGED 
CHANGED / 


)//o Awed /v»» See****** Ayr***™"-* / 






• 03D800 

03E000 

m 03E800 


03D800 
03E000 
03E800 


123 
124 
125 


CHANGED "> 
CHANGEO 
CHANGED / 






• 03F000 
03F800 


03FOOO 
03F800 


126 
127 


CHANGED 1 
CHANGED ) 


'«,*»■ *#£»<*& a***. . 






• 040000 


020800 


065 


CHANGEO "] 








040800 
_ 041000 
• 041800 

042000 


019800 
017800 
018000 
018800 


051 
047 
048 
049 


CHANGEO [ 
CHANGED ( 
CHANGEO 1 
CHANGED J 

CHANGED 7 
CHANGED f 


5eA*i£*J' 4 5 Ajn* -fit****) umo/ ^ /& '9 J+P rt*n~t^p. 






061000 
_^ 061800 


01C800 
OlDOOO 


057 
058 


Sey^w.gn>^ 6 (rx i/orf. 
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Appendix G 

EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 






























*** 


COMMUNICATION 


REGION *** 












m HEX 


BG 


F4 


F3 


F2 


Fl 










• DISP 


04A0 


4590 


44F0 


4450 


43B0 


COMMUNICATION REGION AOORESS 








00 


12/06/73 


12/06/73 


12/06/73 


12/06/73 


12/06/73 


DATE 








^ 08 


7000 


7000 


7000 


7000 


7000 


PP8EG AOOR 








• OA 


7000 


7000 


7000 


7000 


7000 


ENO OF STORAGE PROTECT 








OC 


0000 


0000 


0000 


0000 


0000 


SEEK AOORESS BLOCK. ONLY BG VLO 








• OE 


0000000000 


0000000000 


0000000000 


0000000000 


OOOOOOOOOO 


PROBLEM PROGRAM USERS 










00000000 


00000000 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


AREA IN HEX 








17 


00 


00 


00 


00 


00 


UPSI BYTE IN HEX 








_ 18 


TOMSOMP 


KENSLOOP 


NO NAME 


CALCSIM 


NO NAME 


JOB NAME 








• 20 


00060FFF 


00074FFF 


OOOOOOOO 


O00A1FFF 


OOOOOOOO 


UPPERMOST BYTE OF EACH PPA 








24 


0004232F 


00063C5B 


OOOOOOOO 


0008 AFF6 


OOOOOOOO 


END AOOR OF LAST FETCH OR LOAO 








_ 28 


000423ZF 


OOOOOOOO 


OOOOOOOO 


0008D4DF 


OOOOOOOO 


LARGEST PROBLEM PROGRAM PHASE 








• 2C 


0000 


0000 


0000 


0000 


0000 


LENGTH OF PP LABEL AREA 








2E 


0040 


0020 


0030 


0040 


0050 


PROGRAM IDENTIFICATION KEY 








m 30 


OOOBFFFF 


OOOBFFFF 


OOOBFFFF 


OOOBFFFF 


OOOBFFFF 


END OF STORAGE AOORESS 








• 34 


FO 


FD 


FD 


FO 


FO 


MACHINE CONFIGURATION 








35 


7F 


7F 


7F 


7F 


7F 


SYSTEM CONFIGURATION 








3. 36 


CE0330AOCE00 


CE033000CED2 


CE030000CE50 


CEO3308O4EO0 


CED30000CE50 


JOB CONTROL SWITCHES 








09 3C 


002E 


002E 


002E 


002E 


002 E 


DISK AOOR OF LABEL CYLINDER 








3E 


40F0 


40FD 


40FO 


40F0 


40F0 


AODR OF FOCL 








_ 40 


4104 


4104 


4104 


4104 


4104 


AOOR OF PUB 










4296 


4296 


4296 


4296 


4296 


AODR OF FAVP 








44 


4297 


4297 


4297 


4297 


4297 


AOOR OF JIB 








- 46 


4389 


4389 


4389 


4389 


4389 


AOOR OF TEB 








• 48 


3F00 


3F00 


3F00 


3F00 


3F00 


AODR OF FICL 








4A 


3F06 


3F06 


3F06 


3F06 


3F06 


AODR OF NICL 








_ 4C 


3F0C 


3F0C 


3F0C 


3F0C 


3F0C 


AODR OF LUB 








• 4E 


38 


38 


38 


38 


38 


LINE COUNT FOR SYSLST 








4F 


120673340 


120673340 


120673340 


120673340 


120673340 


SYSTEM OATE 








_ 58 


0000 


0000 


0000 


0000 


0000 


LIOCS COM BYTE 








• 5A 


3C04 


3CD4 


3C04 


3CD4 


3CD4 


ADDR OF PIB TABLE 








5C 


0000 


0000 


0000 


0000 


0000 


LAST CHECK POINT NO. 








_ 5E 


003C 


003C 


003C 


003C 


003C 


JOB ZONE IN MINUTES 








• 60 


4630 


46A8 


4720 


4798 


4810 


AODR OF DIB 








62 


0000 


0000 


0000 


0000 


0000 


CURRENTLY NOT ASSIGNEO 








_ 64 


30CC 


3DCC 


3DCC 


3DCC 


3DCC 


ADOR OF PC OPTION TABLE 








• 66 


3E4C 


3E4C 


3E4C 


3E4C 


3E4C 


ADOR OF IT OPTION TABLE 








68 


3EBC 


3EBC 


3E8C 


3EBC 


3E8C 


AOOR OF OC OPTION TABLE 








A 6 * 


0010 


0010 


0010 


0010 


0010 


KEY OF PROGRAM MITH IT SUPPORT 








• 6C 


0000 


0000 


0000 


0000 


0000 


CURRENTLY NOT ASSIGNEO 








6E 


0000 


0020 


0030 


0040 


0050 


LTK 








_ 70 


00008090 


00008087 


0000807E 


00008075 


0000806C 


SYSPARM 








• 74 


00007118 


00007100 


00007288 


00007340 


0O0073F8 


JOB ACCOUNTING 








78 


00003864 


00003864 


00003864 


00003864 


00003864 


ADDR OF TOO COMMUNICATIONS AREA 








A 7C 


3B04 


3BD4 


3B04 


3B04 


3BD4 


AOOR OF PIB EXTENSION 








• 7E 


5A30 


5A30 


5A30 


5A30 


5A30 


ADOR OF MICR DTF LABEL 








80 


00000000 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


ADDR OF OTAM VECTOR TABLE 








m 84 


04A0 


04A0 


04A0 


04AO 


04A0 


AOOR OF BG COMREG 








• 86 


10E0 


10E0 


10E0 


10E0 


10E0 


RESERVED 








88 


00000588 


00000588 


00000588 


00000588 


00000588 


AODR OF COMREG EXTENSION 








- 8C 


COCO 


COCO 


COCO 


COCO 


COCO 


RESERVED 








• 8E 


03 


00 


00 


00 


00 


DISK CONFIGURATION BYTE 


, (■£> rnxfj 
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Appendix J 

DUMP: Monitoring TIBs, QFILE Records and DATAFIL Records SERVICEABI LITY 

AIDS FOR POWER 
The operator command whose format is shown below causes pointers contained in AND POWER RJE 

execution processor TIBs, in QFILE records, or in DATAFIL records to be 
monitored. The format of the command is: 

TTIB 

Z DUMP,< DFL [tIbI [7dFl1 
END L - 1 «- -J 

Ilst 

When TIB is specified, POWER/POWER RJE monitors the first and last queue 
pointers for all POWER/POWER RJE queues. The TIB fields containing these 
pointers are: 

• TIBRDRQF = pointer to the first JCT in the partition's reader queue 

• TIBRDRQL = pointer to the last JCT in the partition's reader queue 

• TIBPRTQF = pointer to the first JCT in the partition's print queue 

• TIBPRTQL = pointer to the last JCT in the partition's print queue 

• TIB PUNQF = pointers to the first JCT in the partition's punch queue 

• TIBPUNQL = pointers to the last JCT in the partition's punch queue 

• TIBPURGF = pointers to the first JCT in the partition's purge queue 

• TIBPURGB = pointers to the last JCT in the partition's purge queue. 

POWER/POWER RJE verifies that these pointers, which are in the format MCHR, 
are valid disk addresses within the QFILE extent. 

When QFL is specified, POWER/POWER RJE monitors: 

• in the QFILE master record, the first and last queue pointers for the reader, 
print, punch, and purge queues of all partitions 

• in the JCT being processed, the forward and backward chaining pointers. 
Refer to Appendix M for a description of the QFILE. 

POWER/POWER RJE verifies that these pointers are valid disk addresses within 
the QFILE extent and that no pointer in the QFILE master record appears on more 
than one queue. 

When DFL is specified, POWER/POWER RJE verifies that the DATAFIL record 
chain-pointer contains a valid disk address within the DATAFIL extent. 

When END is specified, the diagnostic operations are terminated. 

When LST is specified, the current status of the diagnostic operation is displayed 
on SYSLOG. This option does not affect the status itself. 

When POWER/POWER RJE finds an invalid disk address, it causes an appropriate 
message to be displayed on the console. 

Contents of Registers 

An analysis of the register contents at the time of a dump occasionally provides a 
clue to the cause of the dump. Refer to Chapter 9 in Section 4 for a description 
of general usage for POWER and POWER RJE. 
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The BIM (BTAM Interface Module) Simulator 

This is a software feature of the POWER RJE that simulates the function of the 
BTAM module. The simulator replaces the BIM for one RJE task in simulation 
mode, and any TPIO request from the task is serviced by the simulator on local 
unit record devices. All initialization procedures are performed for the task as if it 
were not in simulation mode. Some of these procedures are reversed to accommo- 
date the simulator. In particular, where the dynamic assignment is made for the 
line, the line is unassigned to permit the simulator to use the CCB in the Line 
Control Block for the card reader. The dynamic assignment is made in accordance 
with the specified card reader in the special start command. The print and punch 
functions are performed on the SYSLST and SYSPCH unit record devices assigned 
by job control during POWER initiation. By using the BIM simulator, execution of 
RJE task overlays may be divorced completely from any line activity, including 
BTAM execution. 



Appendix K 



ANALYZING A DUMP 
OF THE POWER 
PARTITION 



A method of locating POWER control blocks and areas is shown in a series of 
illustrations in Figure K.l . part 1 through 9. Notes within these illustrations 
provide information that will help you in determining the status of the various 
POWER routines at the time the dump was taken in analyzing the contents of 
specific areas of bytes. 



The reference table below is provided to help you to locate descriptions shown in 
the following nine illustrations. 



Block or area to be located 


Reference 


The POWER partition (if it was 
active at the time the dump was taken) 


A 


POWER control blocks: 

GEIMSW (generation option table 

and switch) 

parameter list table 

DATABLKSand PROGBLKS 

table 

DCTs (device control tables) 

TIBTAB 

TIB 

3540 control block 


D 
D R 

R 

F 

C E 

E G-Q 

S 


Program buffers 


S 


Data buffers 


H 



/f 
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□ This area (described in Section 4 of this manual, Chapter 11) is neither used nor 
altered by the POWER program. If POWER was active immediately before the 
dump was taken, the area can be located as follows: 

If the MAP command was executed and is available on the SYSLOG output, the name 

of the job that initiated POWER will be printed together with the partition identifier 

and upper and lower addresses for that partition. The lower address is the address of 

the partition save area of the POWER partition. 

(Note that the address values printed by the MAP command are in decimal.) 

An alternative method is described below: 

1 . Locate the BOUNDARY BOX in the dump as described in this manual. (Refer 
to Chapter 12 Section 4.) 

2. Make a note of the upper and lower partition addresses contained in the 
BOUNDARY BOX. 

3. Locate the PIB2 in the dump as described in this manual. (Refer to Chapter 7 
Section 4.) 

The PIB2 entry belonging to the partition containing POWER will have bit of byte 
1 5 set to 1 (X'80'), and the PI B2 entry belonging to partitions supported by POWER 
will have bit 1 of byte 1 5 set to 1 (X'40') 

4. From this information and the contents of the BOUNDARY BOX you can locate 
the address of the partition save area of the partition containing POWER and of 
the partition supported by POWER. 

Note: If POWER was assembled with a unique name for the 
POWER generation macro, you can look up that name in 
the left of the translated dump columns. Otherwise the name 
is FGPSPOOL. 

The last eight bytes contain the name of the operator communication 
transient phase that has last been executing in the area. This name 
has the format 

FGPTYPxx 

where xx = phase identifiers. 

Examples of phase names: FGPTYPSO or FGPTYPL1. 



The address of the name can be calculated by adding X'400' to the address of 
the last byte of the partition save area. (The partition save area is either X'58' or 
X'78' bytes in length; refer to Section 4 in this manual, 
Chapter 1 1 for a description.) Subtract 8 from the result. 



ANALYZING A DUMP 

OF THE POWER 

PARTITION 



Figure K.l, part 1 of 9 



n. 



xxxxxxxx 



DOS/VS partition save area 



Operator communication 
transient area of 1 K bytes 



FGPTYPxx 



POWER control blocks 



Execution processor co<fe 
and common subroutines 



Supervisor-state code 



Program buffers 



Data buffers 
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ANALYZING A DUMP 
OF THE POWER 
PARTITION 



OOS/VS partition save area 



I 



The following helps you locate the POWER control blocks. For full 
details about the fields of the control blocks, see Chapter 4. Data Areas. 



Operator communication 

! ftansiiefri .- afe#v- • 



POWER control blocks 



Execution processor code 
. ani* dbtniriioH s1&krQtt#ir»&4 



$uperv«&>r~atat# co<& „ 



Prog* am buffers 



Data, buffer* 



m 



FESERVNO 



* FESERVNO 156014 *DOS/VS POWER V.x.M.y 



(hex) 00 



B-H 



Ny 2B 

V.x = version number 
M.y = modification level 



Locating this constant in the translated dump columns is a quick 
method of locating the beginning of the POWER control blocks area. 
FESERVNO (cont.) 



FESERVNO (cont. 



(hex) 2C 




Parameter list table j [ A (PATABLKS)[a (PRQGBIKS) /! 



48 4B 4C 4F 130 

[£j Analyze both the generation options and the generation option switch (GENSW) for the options specified. 



GENSW 



J§. Generation options | 



38 39 3A 3B 3C 3D 



L 



130 



the number of CCB's that can be used for unit 
record or tape I/O (MAXCCB) 

maximum number of data buffers that the POWER 
program can manage (MAXBUFS) 

maximum number of RJE tasks that can be started at 
one time (MAXRJS) 

maximum number of readers and writers that can be 
started at one time (MAXRW) 

•number of DATAFIL disks allowed (NUMDDKS) 

number of tracks in a track group (TRACKGP) 



Figure K.l, part 2 of 9 
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I B 
■ 

1 

2 

3 

4 

5 

6 

7 



Bit Meaning if 1 
TAPE=YES 
RDRCLOS=EXIT 
ACCOUNT=YES 
RJEND=YES 
JOBSEP=YES 
RPS support 
3540 = INPUT 
D5425 = YES 



autostart for a reader task 

1 autostart for a print writer task 

2 autostart for a punch writer task 

3 DIAG=YES 

4 RJE=YES 

5 reserved 

6 READER=YES 

7 READER=YES 
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1 Qj TIBST AT of an execution processor TIB: 



Bit Meaning 

1 = SYSLST output for the current job entry will not be 

intercepted. 

1 reserved. 

2 1 = SYSPCH output for the current job entry will not be 

intercepted. 

3 1 = end-of-job processing for the current job entry takes place. 

4 1 = printed output is being intercepted. 

5 reserved. 

6 1 = punched output is being intercepted. 

7 1 = a job is being executed. 



Appendix K 

ANALYZING A DUMP 

OF THE POWER 

PARTITION 



TIBST AT of a reader TIB: 

Bit Meaning 



1 

2 

3 

4 

5 

6 

7 



1 = task is going to be terminated. 

reserved . 

1 = Sequence of DISKETTE volumes is to be checked. 

reserved. 

1 = task is reading from a 3450. 

1 = both a card reader and a 3540 are assigned. 

reserved. 

1 = task is to be cancelled. 



TIBST AT of a print writer TIB: 



Bit 

0-1 



Meaning 

10 = a stop command has been issued for the task. 

01 = a flush command for the current job has been issued for 
the task. 

1 1 = a restart command for the current job has been issued 

for the task. 
1 = a flush all command has been issued for the task. 
1 = the writer has completed output for the current job. 
1 = restart command directs the task to start from the 

beginning of the current job. 
reserved. 
1 = indicates to a tape writer that job separator pages are 

required. 
1 = a cancel command has been issued for the task 



Figure K.l, part 7 of 9. 
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TIBSTAT of a punch writer TIB: 
Bit Meaning 



Q 



1 =a stop command has been issued for the task. 

1 1 = a flush command for the current job has been issued for the 

task. 

2 1 = a flush all command has been issued for the task. 

3 1 = the writer has completed output for the current job. 
4-6 reserved. 

7 1 = a cancel command has been issued for the task. 

171 TIBSTAT of the operator communications task TIB: 

Bit Meaning 

0-6 Reserved. 

7 POWER command is entered while a previous command is being 

executed. 

TIBACTN of an execution processor TIB: 

XW = disk I/O was in progress or just completed if the task was in control of the CPU. 

X'04' = the contents of a print or punch buffer are to be printed or punched, 

respectively. 
X'08' = a POWER EOJ card is to be processed. 
X'0C = an input card is to be read. 
X'10' = a PRT card is to be processed. 
X'1 4' = a PUN card is to be processed. 
X"I8' =a message is being written on the console. 
X'1 C = either a JOB card (writer-only system) or an SLI card (reader system) is to be 

/processed. 
X'20' = a card from the Source Statement library is to be processed. 

Q TIBACTN of a reader or writer TIB: 

X'00' = disk I/O was in progress or just completed if the task was in control of the CPU. 
X'04' = the task waits for work. This code is set by the execution processor for the 
same partition: 

— for a reader task when all card input for a job is complete 

— for a writer task when all print (or punch) output for a job is complete. 
X'08' = The task waits for completion of 

— a read operation on the associated card reader if a reader task. 

— a print operation on the associated printer if a print writer task. 

— a punch operation on the associated card punch if a punch writer task. 
X'1 8' — The task has issued a message to the console and waits for completion of the 

typing operation. 

It! TIBACTN of the operator communication TIB: 

X'00' = disk I/O was in progress or just completed if the task was in control of the CPU. 
X'04' = The task is inactive, that is, all commands have been processed. 
X'08' = the task has received a command and has initiated processing of same. 
X'10' = I/O for the ACCTFIL is in progress. 

X'1 8' = the task has initialized writing a message on the console and waits for completion 
of the typing operation. 



Note: For POWER start up, the TIBACTN code has been assembled as X'08' and the TSB of the 
associated TIBTAB entry has been assembled at X'03'. 



Figure K.l, part 8 of 9. 
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If the POWER/ RJE program was assembled with a unique name for the 
generation macro you can look up that name in the left of the translated 
dump columns. 



Appendix L 

ANALYZING A DUMP 

OF THE POWER RJE 

PARTITION 



A 1 K area used for the execution of the operator communication 
transient phases. The last eight bytes contain the name of the phase 
that has been executing in the area. This name has the format 

FGPTYPxx 

where xx = phase identifiers 



The address of the name is 
A (partition save area) 



/ X'78' \ v . 
+ )X'58'f + X 



400-8 



*FESERVNO 156014 *DOS/VS POWER v.d,M.d 



5CZ2 



(hex) 14 



■& 




Generation Option table 



2B 2C 



^ 



© V.d. = program version number 

M.d. = program modification number 

Locating this constant in the translated dump columns is a quick 
method of locatingthe beginning of the POWER/ RJE control 
blocks area. 






DOS/VS partition save 
area 



Operator communication 
transient area 



FGPTYPxx 



BTMO0 
{8JBTMO0) 



I I . I . I M l , ■ I I ■ H i 

RJE block name 
m {RJBLKUST* 



User ID list 
(RJUSERS) 



Q 



POWER/ RJE control 
blocks 



h 



Execution processor 

code and common subroutines 

Ill 1 1 l u ll I 



Supervisor-state 6ode 



Program buffers 



lllllllllllllllll Ill II II II II , iiil n li i .i n i li m m ill.. 

Data buffers 

iiiiiiiiiiittiiiWiliiiiMi^^ 



(hex) 2C/ 2F 30 / 33 34 




Generation options 



3D 



(?) Analyze both the generation option switch and the options in the table. 
For details, see (ft 



I feg^gjft^H^»r ^^t^"- ^tjfe>>^ ^ %.^-V /^ gensw 7 



Figure L.l, part 1 of 14 



Q For full details about the fields of the table, see the "Data Area" section. 
For important switches, see Q 
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[§■ continued 



® 



Generation option table 



(hex) 2C 

♦ 

from beginning 
of FGPSPOOL 
CSECT (resident 
POWER code) 



(hex) 00 



34 



i ri ! p 



37 38 39 3A 3B 3C 3D 



L 



B 



130 131 



3^|.iMirnb^f of '■£$&* that ceft be usad fpr unit 

■ : : %|i&ni«iji ; number ef date b*/ffere that trie P0WE8 , 
.:;jp^g|caaf can. rrianage f^X8UN& . . 

• maximum number of RJE tasks that can be started at 
one time (MAXRJS) 

-j^lfiniiujrR.. number of readers a»nd writers that C3rit.be: 
J lifted. & Ortatirito; {MAXRW} ':' ■ 

■ :;^ii#er C-f &ATAPK, iqfesifca attwi iNilMODKS* 

^$l]ijlic*r »f tracks m arrack stb»p (TflACKGtP) 



GENSW Hi 



Sit Meaning if 1 



TAPE *YE3 we* specified ... 
&>R€tO$*£ XIT was SpecflFwd 
ACCOU*<t^$ vy^>pec»«6d 

RJE is included (MAXRJS=1 to 5 was specif iedj 
J08SEP« YES was specified 
RPS support 

JOBSEP-YES was specified 
D5425 - YES 

autostart for a reader task was specified 
autostart for a pnrn writer task was specified 
i autostart for a punch Wfftar tasic was specified 
DtA$«YE$ was specified 

RJE=YES was specified 



REA0£R*YES was specified 
READER** YSS wae specified 



Figure L.l, part 2 of 14 
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DOS/VS Serviceability Aids and Debugging Procedures 

GLOSSARY 



This glossary contains technical terms associated with the subject of this publication. A more general range of terms 
is contained in IBM Date Processing Glossary, GC20-1699. 

IBM is grateful to the American National Standards Institute (ANSI) for permission to reprint its definitions from the 
American National Standard Vocabulary for information Processing (copyright © 1970 by American National Standards 
Institute, Incorporated) which was prepared by subcommittee X3K5 on Terminology and Glossary of American 
National Standards Committee X3. These definitions are indicated by an asterisk. 



B 



address translation. The process of changing the 
address of an item of data or an instruction from its 
virtual address to its real storage address. See also 
dynamic address translation. 

asynchronous, without regular time relationship. 

auxiliary storage. Data storage other than real 
storage; for example, storage on magnetic tape or 
disk. Synonymous with external storage, secondary 
storage. 



basic control mode. When PSW bit 12 is 0, PSW 

format and system operation are compatible with 
standard System/360 operation. This is the basic 
control mode in which control registers 0, 8, and 
14 are available to the system. Abbreviated to BC 
mode. See also "Extended Control Mode." 

BTAM (basic telecommunications access method). 
A basic access method that permits a READ/ WRITE 
communication with remote devices. 

buffer. (1) A storage device in which data is 
assembled temporarily during data transfer. (2) During 
I/O operations, a portion of real storage from which 
data is read or into which data is written. 



channel program. One or more Channel Command 
Words (CCWs) that control(s) a specific sequence 
of channel operations. Execution of the specific 
sequence is initiated by a single start I/O instruction. 

channel program translation. In a channel program, 
replacement, by software, of virtual addresses with 
real addresses. 

command control block (CCB). A 16-byte field 
required for each channel program executed by 
physical IOCS. This field is used for communication 
between physical IOCS and the problem program. 

communication region. An area of the supervisor 
set aside for interprogram and intraprogram communi- 
cation. It contains information useful to both the 
supervisor and the problem program. Abbreviated 
comreg. (Not to be confused with the COMRG macro 
instruction). 



control program. A program that is designed to 
schedule and supervise the performance of data 
processing work by a computing system. 

control registers. A set of registers used for operating 
system control of relocation, priority interruption, 
program event recording, error recovery, and masking 
operations. 

core-wrap mode. The method of operation that 
records the events of a trace in the PD area or an 
alternate area (used by PDAIDS). It is the default 
process when no output device for a PDAID trace 
has been specified. 



D 



DTF (define the file) macro instruction. A macro 
instruction that describes the characteristics of a 
logical input/ output file, indicates the type of 
processing for the file, and specifies the I/O areas 
and routines to process the file. 

default value. The choice among exclusive alternatives 
made by the system when no explicit choice is 
specified by the user. A default value is indicated by 
underlining in tables listing parameters. 

diskette. A flexible magnetic oxide coated disk, 
permanently enclosed in a semi-rigid protective 
plastic jacket approx, 8 inches square. During data 
processing operations the disk turns freely within 
the jacket. It is capable of storing 1898 128 character 
data records. 

dump. (1) To print out the contents of all or part 
of virtual storage or of auxiliary storage (2) The 
data resulting from the process as in (1). 

dynamic address translation (DAT). (1) The change 
of a virtual storage address to an address in real 
storage during execution of an instruction. (2) A 
hardware feature that performs the translation. 



emulator (1) * A device or computer program that 
emulates. (2) The combination of programming 
techniques and special machine features that permits 
a given computing system to execute programs 
written for another system. 
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environmental recording, editing, and printing 

(EREP). A program that processes the data 
contained on the system recorder file. 
error recovery procedures. Procedures designed to 
help isolate, and, when possible, to recover from 
hardware errors in equipment. The procedures are 
often used in conjunction with programs that record 
the statistics of machine malfunctions. 

error volume analysis (EVA). With this option, the 
system issues a message to the operator when a 
number of temporary read or write errors (specified 
by the user at system generation time) has been 
exceeded on a currently accessed tape file. 

event. An occurrence of significance to a task; 
typically, the completion of an asynchronous 
operation, such as input/ output. 

extent. The physical locations on Input/ Output 
devices occupied by or reserved for a particular 
volume. 

extended control mode. When PSW bit 1 2 is set to 1 , 
the PSW format is changed from that used for 
standard System/360 operation: the channel mask 
bits, instruction length code, and interruption code 
are removed, and additional mode and mask bits are 
included. This is the extended control mode, in 
which all control registers are available to the system 
for control of facilities that are particular to System/370. 
Abbreviated to EC mode. See also "Basic Control Mode." 



fetch. (1) To bring a program phase into real storage 
from a core image library or from the page data set 
for immediate execution. (2) The routine that 
retrieves requested phases and loads them. (3) The 
name of a macro instruction (FETCH) used to 
transfer control to the system loader. (4) To transfer 
control to the system loader. 

* file. A collection of related records treated as a unit. 
For example, one line of an invoice may form an item, 
a complete invoice may form a record, the complete 
set of such records may form a file, the collection of 
inventory control files may form a library, and the 
libraries used by an organization are known as its 
data bank. 



H 



fixed page. 

paged out. 



A page in real storage that is not to be 



F/L Trace (Fetch/Load Trace). A program that 
records information about phases and transients as 
they are called from a core image library. 

GSVC Trace (Generalized Supervisor Calls Trace). 

A program that records SVC interrupts as they occur. 
All or a selected group of SVCs can be traced. 



hard copy. A printed copy of machine output in a 
visually readable form, for example, a printed 
recording of the messages displayed on the System/370 
Model 125 video display unit. 

hard stop. A condition, usually caused by an error, 
in which the CPU is stopped and is not executing the 
microprogram. 

* hardware. Physical equipment, as opposed to the 
computer program or method of use, for example, 
mechanical, magnetic, electrical, or electronic devices. 
Contrast with software. 



I 



Input Job Stream. A sequence of job control state- 
ments entering the system, which may also include 
input data. 

interface. A shared boundary. An interface might 
be a hardware component to link two devices or it 
might be a portion of storage or registers accessed by 
two or more computer programs. 

interrupt. A break in the normal sequence of 
instruction execution. It causes an automatic transfer 
to a preset storage location where appropriate 
action is taken. 

invalid page. A page that cannot be directly addressed 
by the dynamic address translation feature of the 
central processing unit. 

I/O area. An area (portion) of real storage into which 
data is read or from which data is written, the term 
buffer is often used in place of I/O area. 

I/O Trace (Input/Output Trace). A program that 
records I/O device activity for all or a selected group 
of I/O devices. 

IOCS (input/output control system). A group of 
macro instruction routines provided by IBM for 
handling the transfer of data between main storage 
and external storage devices. 

irrecoverable error. A hardware error which cannot 
be recovered from by the normal hardware and retry 
procedures. 

job. (1) * A specified group of tasks prescribed as a 
unit of work for a computer. By extension, a job 
usually includes all necessary computer programs, 
linkages, files, and instructions to the operating 
system. (2) A collection of related problem programs, 
identified in the input stream by a JOB statement 
followed by one or more EXEC statements. 
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relocatable library. A library of relocatable object 
modules and IOCS modules required by various 
compilers. It allows the user to keep frequently used 
modules available for combination with other 
modules without recompilation. 

resource. Any facility of the computing system or 
operating system required by a job or task, and 
including main storage, input/output devices, the 
central processing unit, data files, and control and 
processing programs. 

Rotational Position Sensing. A standard feature of IBM 
3330/3333 and an optional feature of IBM 3340 disk 
storage devices. It permits a device to disconnect from 
a block multiplexer channel (or its equivalent on Model 
31 15/3125 CPUs) during rotational positioning opera 
operations, thereby allowing the channel to service other 
devices on the channel during the positioning delay. 

routine. An ordered set of instructions that may have 
some general or frequent use. 



Second Level Directory (SLD). The table, located 
in the Supervisor and containing the highest phase- 
names found on the corresponding directory tracks 
of the system core image. 

segment. A continuous 64K area of virtual storage, 
which is allocated to a job or system task. 

segment table (SGT). A table used in dynamic 
address translation to control user access to virtual 
storage segments. Each entry indicates the length, 
location, and availability of a corresponding page 
table. 

segment translation exception. A program interruption 
that occurs when a virtual address cannot be translated 
by the hardware because the invalid bit in the segment 
table entry for that address is set. See also page 
translation exception, translation specification 
exception. 

self-relocating. A programmed routine that is loaded 
at any double word boundary and can adjust its 
address values so as to be executed at that location. 

self-relocating program. A program that is able to 
run in any area of storage by having an initialization 
routine to modify all address constants at object time. 

selector channel. A channel designed to operate with 
only one I/O device at a time. Once the I/O device is 
selected, a complete record is transferred one byte at 
a time. 

SEREP. A stand-alone environment recording, 
editing, and printing program that makes the data 
contained in an error logout area of real storage 
available for further analysis. 



DOS/VS Serviceability Aids and Debugging Procedures 

GLOSSARY 
Shared Virtual Area (SVA): The last part of the 
virtual system address space that contains phases 
which are reenterable and relocatable and which can 
be shared between partitions. 

soft stop. A condition in which the CPU has stopped 
processing but continues to handle any requested 
interruptions. 

stand-alone dump. A program that displays the 
contents of the registers and all of real storage and that 
runs independently and is not controlled by DOS/VS. 

subtask. A task in which control is initiated by a 
main task by means of a macro instruction that 
attaches it. 

* storage protection. An arrangement for preventing 
access to storage for either reading, or writing, or 
both. 

system generation. The process of tailoring the IBM 
supplied operating system to user requirements. 

system debugging aids. A set of routines provided 
to trace specific program events by using the program 
event recording facilities. Abbreviated SDAIDS. 

System Directory List (SDL). A list of highly used 
phases (either only in the system CIL or also in the 
SVA). This list is placed in the SVA. 

system recorder file. The data file that is used to 
record hardware reliability data. 

task. A unit of work for the central processing unit 
from the standpoint of the control program. 

task selection. The supervisor mechanism for 
determining which program should gain control of 
CPU processing. 

teleprocessing. The processing of data that is received 
from or sent to remote locations by way of telecom- 
munication lines. 

terminal. (1) * A point in a system or communication 
network at which data can either enter or leave. (2) Any 
device capable of sending and receiving information 
over a communication channel. 

Terminating partition. This is a partition owning a 
program which is in the process of being terminated 
either because of a program cancel condition or 
because of EOJ. 

trace. (1) To record a series of events as they occur. 
(2) The record of a series of events. 

: tracing routine. A routine that provides a historical 
record of specified events in the execution of a program. 
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track hold. A function for protecting DASD tracks 
that are currently being processed. When track hold is 
specified in the DTF, a track that is being modified by 
a task in one partition cannot be concurrently accessed 
by a task or subtask in another partition. 

transient area. An area in the supervisor used for 
temporary storage of transient routines, such as non- 
resident supervisor call or error-handling routines. 

transient routines. These self-relocating routines are 
permanently stored on the system residence device 
and loaded (by the supervisor) into the transient area 
when needed for execution. 

translation specification exception. A program inter- 
ruption that occurs when a page table entry, segment 
table entry, or the control register pointing to the 
segment table contains information in an invalid 
format. See also page translation exception, segment 
translation exception. 



U 



user program, see problem program. 

unrecoverable error, see irrecoverable error. 

utility program. A program designed to perform a 
routine task, such as transcribing data from one 
storage device to another. 



V 



virtual address. An address that refers to virtual 
storage and must, therefore, be translated into a real 
storage address when it is used. 



virtual address area. In DOS/VS, the area of virtual 
storage whose addresses are greater than the highest 
address of the real address area. 

virtual mode. In DOS/VS, the mode of a program 
which may be paged. 

virtual storage. Addressable space that appears to the 
user as real storage, from which instructions and data 
are mapped into real storage locations. The size of 
virtual storage is limited by the addressing scheme of 
the computing system and by the amount of auxiliary 
storage available, rather than by the actual number 
of real storage locations. 

virtual storage access method (VSAM). VSAM is an 

access method for direct or sequential processing of 
fixed and variable length records on direct access 
devices. The records in a VSAM file can be organized 
either in logical sequence by a key field (key sequence) 
or in the physical sequence in which they are written 
on the file (entry-sequence). A key sequenced file has 
an index, an entry-sequenced file does not. 

volume. (1) That portion of a single unit of storage 
media which is accessible to a single read/write mechanism, 
for example, a drum, a disk pack, or part of a disk 
storage module. (2) A recording medium that is 
mounted and dismounted as a unit, for example, a reel 
of magnetic tape, a disk pack, a data cell. 

VSAM access method services. A multifunction utility 
program that defines VSAM files and allocates space 
for them, converts indexed sequential files to key- 
sequenced files with indexes, facilitates data portability 
between operating systems, creates backup copies of 
files and indexes, helps make inaccessible files accessible, 
and lists file and catalog entries. 
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This sheet is for comments and suggestions about this manual. We would appreciate your 
views, favorable or unfavorable, in order to aid us in improving this publication. This form 
will be sent directly to the author's department. Please include your name and address if 
you wish a reply. Contact your IBM branch office for answers to technical questions about 
the system or when requesting additional publications. Thank you. 



Your comments* and suggestions: 



* We would especially appreciate your comments on any of the following topics: 

Clarity of the text Accuracy Index Illustrations Appearance Paper 

Organization of the text Cross-references Tables Examples Printing Binding 



13U33-&3HU-1 



YOUR COMMENTS, PLEASE 



This manual is part of a library that serves as a reference source for systems analysts, 
programmers and operators of IBM systems. Your answers to the questions on the back of this 
form, together with your comments, will help us produce better publications for your use. Each 
reply will be carefully reviewed by the persons responsible for writing and publishing this 
material. All comments and suggestions become the property of IBM. 

Please note: Requests for copies of publications and for assistance in utilizing your IBM sys- 
tem should be directed to your IBM representative or to the IBM sales office serving your 
locality. 
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